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HOW TO USE THIS BOOK 


This publication describes the internal organization and logic 
of the linkage editor. The linkage editor, a processing 
program, combines and edits modules to produce a load module 
that can be loaded into virtual storage by the control program. 


This manual consists of seven sections. The first three 
sections describe the overall organization, beginning with a 
general description and progressing to a detailed discussion of 
the components of the linkage editor. The last four sections 
are reference sections for analyzing storage dumps and for 
accessing specific areas of code in the program listing. 


The seven sections are: 


1. "Introduction”™ describes the linkage editor as a whole, 
including its relationship to the operating system. The 
major divisions of the program and the relationships among 
them are also described. 


2. “Method of Operation” provides: 
a. An overview of the logic of the linkage editor 
b. Detailed descriptions of specific operations 


Use the operation diagrams included at the end of this 
section with the text. They illustrate the flow of data 
through the tables and buffers used during linkage editor 
processing. 


3. "Program Organization™ describes the organization of the 
linkage editor. Program components (modules, control 
sections, and routines) are described both in terms of their 
operation and their relation to other components. 


4. "Microfiche Directory” helps the reader find the named areas 
of code in the program listing. Microfiche cards contain 
the program listing. 


5. "Table Layouts” are used for analysis of storage dumps. 
They are illustrated in this section. 


6. "Diagnostic Aids™ includes general register contents at 
entry to modules, and an error message—module 
cross-reference table. 


7. "Appendix" includes input conventions and record formats. 


Read the Introduction first for an overview of the linkage 
editor within the operating system. Consult the Method of 
Operations section for the overall logic of the linkage editor. 
Finally, read the Program Organization section for detailed 
examination of the program components. Refer to the last four 
sections for named areas of code, table layouts, register 
contents, input conventions, and record formats while reading 
the Method of Operation and Program Organization sections. 
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If more detailed information is required, refer to the contents 
and coding in the linkage editor program listings. Other 
publications that are required for an understanding of the 
linkage editor are: 

e MVS/370 Data Management Services, 6C26-4058 

e MVS/7370 Data Management Macro Instructions, GC26-4057 

e OS/VS2 MVS JCL, GC28-0692 


The reader should also refer to the corequisite publications: 


° MVS/7370 Linkage Editor and Loader, 6C26-4061 


e OS/VS2 System Programming Library: Debugging Handbook, 
Volumes 1 through 3, GC28-1047 through GC28-1049 
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INTRODUCTION 
This section describes the purpose, organization, and internal 
operation of the linkage editor, and its relationship to the 
operating system. 
R OF LINKAGE EDITOR 


The linkage editor is one of the processing programs of the 
operating system. It is a service program used in conjunction 
with the language translators to prepare machine-language 
programs from symbolic-language programs written in FORTRAN, 
COBOL, report program generator, assembler language, or PL/I. 
Linkage editor processing is a necessary step that follows 
source program assembly or compilation. 


Linkage editor processing allows the programmer to divide a 
program into several parts, each containing one or more control 
sections. Each part may then be coded in the programming 
language best suited to it and may then be separately assembled 
or compiled by a language translator (Cunder the rules applicable 
to each language translator). 


The primary purpose of the linkage editor is to combine and link 
object modules (the output of the language translators) into a 
load module. In that load module, all cross-references between 
control sections are resolved as though they had been assembled 
or compiled as one module. The load module produced by the 
linkage editor consists of executable machine-language code in a 
format that can be loaded into virtual storage and relocated by 
program fetch. 


In addition to combining and linking object modules, the linkage 
editor performs the following functions: 


e Library Calls. Modules (such as standard subroutines) stored 
in a library can be placed in the input to the linkage 
editor, either automatically or upon request. If unresolved 
external references remain after all input to the linkage 
editor is processed, an automatic library call routine 
retrieves the modules required to resolve the references. 
However, unresolved external references marked "weak call” 
or "never call” are not resolved by this routine. 


e Program Modification. Control sections can be replaced, 
deleted, or rearranged Cin overlay programs) during linkage 
editor processing, as directed by linkage editor control 
statements. Common control sections generated by the 
FORTRAN, PL/I, and assembler language translators are 
provided locations within the output load module. 


e Order _ and Page Support. The linkage editor can order control 
sections in the sequence specified on the linkage editor 
control statements, and can assign control sections to page 
boundaries according to the control statements. 


e Addressing Mode, Residence Mode, and Read-Only Support. The 


linkage editor assigns an addressing mode for the entry 
points into a load module, assigns a residence mode for the 
load module, and indicates which control sections are 
read-only in a nucleus load module. 


e Program Processing History. CSECT identification records 
built during linkage editor processing contain data 
describing the language translators and the linkage editor 

that produced the program, any modifications to that program 
{ by AMASPZAP, and, optionally, up to 40 characters of user 
data for each control section within the program. 
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e Overlay Module Processing. The linkage editor prepares 
modules for overlay by assigning relative locations within 
the module to the overlay segments and by inserting tables 
to be used by the overlay supervisor during execution. ) 


e Options and Error Messages. The linkage editor can: 


- Process special options that override automatic library 
calls or the effect of minor errors 


_ Produce a list of linkage editor control statements that 
were processed 


- Produce coded diagnostic messages and a directory 
describing those diagnostic messages that were printed 
out during linkage editor processing 


aad Produce a module map or cross-reference table of control 
sections in the output load module 


RELATIONSHIP TO THE OPERATING SYSTEM 


GENERAL DESCRIPTION 


The linkage editor has the same relationship to the operating 
system as any other processing program. Control is passed to 
the linkage editor in one of three ways: 


1. As a job step, when the linkage editor is specified on an 
EXEC job control statement in the input stream 


2. As a subprogram, via the execution of a CALL macro 
instruction (Cafter execution of a LOAD macro instruction), a 
LINK macro instruction, or an XCTL macro instruction 


3. As a subtask, in multitasking systems, via execution of the 
ATTACH macro instruction 


2 
Linkage editor input may consist of a combination of object 
modules, load modules, and linkage editor control statements. 
The prime function of the linkage editor is to combine these 
modules, in accordance with requirements stated on control 
statements, into a single output load module that can be 
relocated and loaded into real storage by program fetch for 


execution. Output load modules are placed into partitioned data 
sets (libraries). 


Each module to be processed by the linkage editor has an origin 
that was assigned during assembly, during compilation, or during 
a previous execution of the linkage editor. Each module in the 
input to the linkage editor may contain symbolic references to 
control sections in other modules; such references are called 
external references. 


To produce an executable output load module, the linkage editor: 


1. Assigns relative virtual storage addresses to the control 
sections to be included in the output module. Because each 
input module has an origin that was assigned independently 
by a language translator, the order of the addresses in the 
input is unpredictable. (Two input modules, for example, 
may have the same origin.) The linkage editor assigns an 
origin to the first control section and then assigns 
addresses to all other control sections in the output 
relative to either this origin or to the last control 
section aligned on a page boundary. 


2. Resolves external references in the input modules. 
Cross-references between control sections in different 
modules are symbolic, and must be resolved (translated into | } 
relocatable machine addresses) in relation to the contiguous 
virtual storage addresses assigned to the output load 
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MODULE STRUCTURE 


module. These symbolic cross-references are made by means 
of address constants. 


The linkage editor calculates the new address of each 
relocatable expression in a control section and determines the 
assigned origin (value) of the item to which it refers. 


Linkage editor processing is affected by specified options, 
operations requested on control statements, module attributes 
contained in partitioned data set directories, and control 
information contained within the modules themselves. The 
following paragraphs describe the relationship of module 
structure, linkage editor options, and module attributes to 
linkage editor processing. 


Object modules and load modules have the same basic logical 
structure (see Figure 1). Each consists of: 


° Control dictionaries, containing the information necessary 
to resolve symbolic cross-references between control 
sections of different modules, and to relocate address 
constants 


° Text, containing the instructions and data of the program 


@ An end of module CEOM) indicator CEND record in object 
modules; EOM indication in load modules) 


Input Output 
Object Module Load Module 





Linkage 


Editor 





Figure 1. Linkage Editor Processing—Simple Case 


Each language translator usually produces two kinds of control 
dictionaries: an external symbol dictionary CESD) and a 
relocation dictionary (RLD). An object module always contains 
an ESD; a load module contains an ESD unless it is marked with 
the "not editable” attribute. Object and load modules usually 
contain an RLD Cunless there are no relocatable address 
constants in the module). Control dictionary entries are 
generated when external symbols, address constants, or control 
sections are processed by a language translator. 


External Symbol Dictionary 


An external symbol dictionary contains entries for all external 
symbols defined or referred to within a module. (An external 
symbol is one that is defined in one module and can be referred 
to in another.) Each entry identifies a symbol, or a symbol 
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reference, and gives its location, if any, within the module. 

When combining input modules, the linkage editor resolves 

references between different input modules by matching the 

referenced symbols to defined symbols; it does this by searching ' 
for the external symbol definitions in each input module's ESD. ; 
There is an ESD entry for each named control section and each 

named common area. The ESD also contains entries that identify 
unnamed control sections and unnamed common areas. 


Relocation Dictionary 


The relocation dictionary (RLD) lists all relocatable address 
constants that must be modified when the linkage editor produces 
an output load module. The linkage editor uses the RLD whenever 
it processes a module. The RLD is also used to adjust the value 
of address constants after program fetch reads an output load ; 
module from a library and loads it into virtual storage for 
execution. The RLD contains at least one entry for every 
relocatable address constant in a module. An RLD entry 
identifies an address constant by indicating both its location 
within a control section and the external symbol Cin the ESD) 
whose veuue must be used to compute the value of the address 
constant. 


Composite Dictionaries 


An output load module is composed of all input object modules 
and input load modules processed by the linkage editor Cexcept 
those that are replaced or deleted). The control dictionaries 
of an output module are therefore a composite of all the control 
dictionaries in the linkage editor input. The control 
dictionaries of a load module are called the composite ESD 
(CESD) and the RLD. 


Figure 2 on page 5 shows how the control dictionaries of two 

input modules are combined into composite dictionaries by the | 
linkage editor. The control dictionaries and their associated } 
text are interrelated through a system of line numbers and 

pointers. Within an input module, each ESD item on which an 
address constant may depend has a line number CESD identifier, 

or ESD ID); the line number indicates the position of the item, 
relative to the other ESD items associated with the text.! Every 
item of text in an object or load module has associated control 
information that describes it. This control information 

includes the ESD ID of the ESD item for the control section that 
contains the text. (CIn Figure 2, the ESD ID of the text item 

that contains X and Y points to line 1 of the ESD for input 

module 1. The ESD ID of the text item containing Z points to 

line 1 of the ESD for input module 2.) 


Each RLD item must point to two ESD items: 


1. The ESD item for the symbol on which the a pore constant 
depends. This is referred to by the RLD 
CR pointer). 


2. The ESD item for the control section that contains the 
address constant. This is referred to by the RLD position 
pointer CP pointer). 


1 In an object module, one type of ESD item (ID) may have 
associated text or address constants that depend on it (see 
"ESD Processing™). Such ESD items are excluded from the j 
numbering system. 
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( Figure 2. Combining Control Dictionaries 


In input module 1, X and Y are address constants in the same 
control section (CSECT A). X refers to a symbol in CSECT A; 
therefore, both pointers of its associated RLD item refer to the 
ESD entry for CSECT A Cline 1). The value field of Y refers to 
a symbol ina different control section (CSECT C); therefore, 
the R pointer of its associated RLD points to the ESD entry for 
the external reference (line 2), whereas the P pointer refers to 
the ESD entry for its control section Cline 1). 


When the linkage editor combines the input modules, it must 
maintain this system of pointers by renumbering the ESD items to 
reflect their relative positions in the CESD of the output 
module. It must also update the RLD pointers and control 
information for the text so that they refer to the renumbered 
ae gene the resulting CESD and RLD items are shown in 

igure 2. 


LINKAGE EDITOR OPTIONS 


Options for error diagnostics, processing, and space allocation 
may be specified by parameters listed on the EXEC card, or they 
may be passed internally by a program requesting the linkage 
editor via LINK, LOAD, ATTACH, or XCTL macro 

instructions.* If the options are passed internally, the user 
can also provide alternates for the standard ddnames.* If the 


2 For more information, see Data Management Services and Data 
Management Macro Instructions. 
3 For more information, see JCL. 
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options are not user-specified, the defaults are used. The 
options that may be specified are as follows: 
® LIST. A list of all linkage editor control statements is 

written on the diagnostic output data set. ) 
® MAP. A module map, which lists external names and their 


storage addresses, is written on the diagnostic output data 
set. 


S Cross-reference table (XREF). A cross-reference table, 
which includes a module map and a list of all address 
constants that refer to other control sections, is written 
on the diagnostic output data set. 


e TERM. Error messages are directed to the terminal data set 
as well as to the diagnostic output data set. 


° LET. The output module is marked as executable even though 
a severity 2 error condition was found during processing. 


e Exclusive call (XCAL). The output module is marked as 
executable even though valid exclusive references between 
overlay segments have been made. 


e No automatic library call (NCAL). The automatic library 


call mechanism is not to be invoked to resolve external 


references. 
e SIZE (value 1, value 2). The user can supply two values to 


specify the maximum amount of storage to be obtained for 
linkage editor processing and what amount of the gotten 
storage is to be used as the load module buffer. 


e DCBS. The linkage editor initialization routine examines 
the SYSLMOD DD statement for a DCB BLKSIZE parameter and 
uses that value, if it is acceptable, for its block size 
limit. If the DEVTYPE capacity is less than the specified P 
block size, the DEVTYPE value is used. i 





MODULE ATTRIBUTES 


When the linkage editor generates a load module in a library 
partitioned data set (PDS), it places an entry for the module in 
the PDS directory. This entry contains "attributes” describing 
the structure, content, and logical format of the load module. 
The control program uses these attributes to determine how a 
module is to be loaded, what it contains, whether or not it is 
executable, whether it is executable more than once without 
reloading, and whether it can be executed by concurrent tasks. 


Some options for module attributes can be specified by the user; 
others are specified by the linkage editor as a result of 
information gathered during processing. In the following list, 
oo oue es marked with an asterisk (%) cannot be specified by 
the user. 


® Reenterable (RENT). A reenterable module can be executed by 
more than one task at a time and cannot be modified by 
itself or by any other module during execution; that is,» a 
task may begin executing a reenterable module before a 
previous task has finished executing it. 


e Refreshable CREFR). A refreshable module cannot be modified 
by itself or by any other module during execution. A 
refreshable module can be replaced by a new copy during 
execution by a recovery management routine without changing 
either the sequence or results of processing. 


e Serially reusable (REUS). A serially reusable module will 
be executed by only one task at a time, and will either 
initialize itself and/or will restore any instructions or 
any data in the module that it alters during its execution. 
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Overlay format COVLY). A load module structured for overlay 
includes a segment table (SEGTAB) to enable the overlay 
supervisor to load the proper segments, and at least one 
ENTAB to assist in passing control from one segment to 
another. If a load module has the overlay format attribute, 
the reenterable, reusable, refreshable, hierarchy, scatter, 
addressing mode, and residence mode attributes cannot be 
present. 


ierarch ormat (CHIAR). When a HIARCHY statement is 


detected, the "number™ and "name" operand values are used in 
building the scatter table and the translation table. The 
high-order byte of each CSECT address entry contains the 
hierarchy number that is included in the GETMAIN request for 
main storage for program loading. Hierarchy information is 
used only when the program is loaded under the OS system. 


Test (TEST). If this module is an assembler language 
program and testing by the test translator or the TSO TEST 
command is desired, this attribute can be specified. Test 
will cause SYM records to be written. Note that modules 
using TESTRAN should not be marked with the RENT, REUS, or 
REFR attribute. 


Only loadable (OL). This attribute indicates that the 
control program may load this module only through the 
execution of the LOAD macro instruction. 


Scatter format (SCTR). In the OS environment, a load module 
in scatter format is suitable for block or scatter loading. 
The scatter table, translation table, and the relocation 
dictionary maintain logical linkage between scattered 
control sections when program fetch loads them into storage. 
In the virtual storage environment, the scatter format is 
ignored by program fetch. The SCTR attribute is, however, 
relevant in the link-editing of a nucleus for a virtual 
storage system, which requires the scatter and translate 
tables for its proper initialization. 


ALIGN2. If the ALIGN2 attribute is present, all control 
sections or named common areas specified on the PAGE control 
statements are placed in storage on 2K-byte page boundaries. 
The ALIGN2 attribute also aligns on 2K-byte page boundaries 
those control sections or named common areas associated with 
the "P™ operand on the ORDER control statement. 


¥Block format. If neither the overlay nor scatter 
attributes are specified, it is implied that the module can 
only be block loaded. The control program will load the 
module only if enough contiguous storage is available for 
the entire module. 


¥Executable. This attribute indicates that linkage editor 
did not find any errors that would prevent successful 
execution. If this attribute is not present, the control 
program will not load the module. 


*Module contains one text record and no relocation 
dictionary records. This attribute indicates that the 


control program does not have to allocate storage for 
relocation dictionary items when loading the module. It 
also indicates that the first text record is the last one; 
there is no control record following it. The entire module 
can be read by program fetch in a single read operation. 


Downward compatible (DC). This attribute indicates that the 


module can be processed by either the level E or level F 
linkage editor. The downward-compatible attribute is 
assumed by the level E linkage editor. Modules processed by 
the level F linkage editor that are not marked “downward 

a a a cannot be processed by the level E linkage 
editor. 
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e XLinkage editor assigned origin of first text record is 
zero. If this attribute is present, the first byte of 
instruction or data in the first text record is assigned to 
location zero. 


e *Entr oint assigned by linkage editor is zero. This 
attribute indicates that the entry point is at the first 
byte of the module. 


e ¥No relocatio ictionary item resent. This attribute 
indicates to the control program that no allocation of 
storage is necessary to receive relocation dictionary items 
when program fetch loads them into virtual storage. 


e Not editable (NE). This attribute indicates that the load 
module cannot be accepted by the linkage editor for 
subsequent processing. The CESD from an output load module 
is dropped to conserve space on the library. 


e *Symbol statements present. If a module produced by the 


assembler language translator is to be tested by the test 
translator CTESTRAN) or the TSO TEST command, it may contain 
a testing symbol dictionary. In a load module, this 
dictionary contains the information from the SYM statement 
images that were in the input to the linkage editor. 


e Authorization Code (AC). The output load module is assigned 
an authorization code that determines whether or not the 
load module may use restricted system services and 
resources. 


e Addressing Mode (AMODE). The entry points—either main, 
true alias, or alternate—into the output load module are 
assigned the addressing mode that is to be in effect when 
the load module is entered at those entry points. 


e Residence Mode (RMODE). The output load module is assigned 
the residence mode that applies to that load module when it 
is loaded into virtual storage for execution. 


e *Read-Only Control Section. "Read-only”™ is an attribute of 
a control section deliberately created as such by 
specification of the control section as an RSECT to the 
language translator. The attribute is effective only when 
the control section is included in the nucleus load module 
for an MVS/XA system; otherwise it is ignored. The 
attribute is obtained from the ESD entries for the read-only 
control sections and is reflected in the scatter table 
oe for those control sections in the nucleus load 
module. 


LINKAGE EDITOR PROCESSING FOR ATTRIBUTES 


Several examples are given here of how linkage editor processing 
is affected by attributes specified by the user. Figure 1 on 
page 3 shows a simple case in which a single object module, 
containing only one control section, is processed by the linkage 
editor for block loading. 


Figure 3 on page 9 shows the processing of an object module and 
a load module, each containing several control sections. In 
this example, test translator macro instructions were included 
in an assembler language source program and test symbol (SYM) 
records were produced by the assembler language translator. The 
TEST and OVLY attributes were specified in the control 
information passed to the linkage editor, and overlay control 
statements were included in the input to the linkage editor. 
With these attributes, the output load module produced by the 
linkage editor contains: 


e SYM records to be used by the test translator. (CIf the TEST 
attribute is not specified, input SYM records are not 
included in the output load module.) These records contain 
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blocked SYM and ESD statements created during a previous 
execution of the linkage editor. SYM records in load 
modules are passed unmodified through the linkage editor to 


the output load module. 


e A_composite ESD. CESD records contain the ESD items for the 
module. There is a maximum of 15 ESD items per record on 
the output record. The first 8&8 bytes of the CESD record 
contain control information pertaining to the ESD items in 
the record. This information consists of the ESD ID of the 
first ESD item and the number of bytes of ESD items in the 
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Figure 3. Linkage Editor Processing for the Overlay and TEST Attributes 





e CSECT Identification Records (CIDR). 


The IDRs are input from 


either an input load module, an END record, or the linkage 


editor IDENTIFY control statement. 


IDRs may contain data: 


= Identifying the language translator creating the control 
section, its level, and the translation date 


Cs Describing the most recent processing by the linkage 


editor 


= Describing any modification to the executable code of a 


control section 
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- Supplied by a user and associated with the executable 
code of a control section 


Note: The user-supplied data is specified on the IDENTIFY 
control statement. 


A control record, or a composite control/RLD record, 
preceding each text record. The RLD portion, if present, 
contains the RLD items used to relocate the previous text.‘ 
The control portion may contain: 


- An end of segment (E0S) indication, if the following 
text record is the last text record of an overlay 
segment. > 


_ An end of module CEOM) indication, if the following text 
record is the last text record of the module.3 


= The number of bytes of RLD information that follow, if 
1t 15S a composite control/RLD record. 


- The number of bytes of control information. 


The control portion also contains the IDs and lengths Cin 
bytes) of all the control sections in the following text, to 
a maximum of 60, and a channel command word (CCW). The 
channel command word contains the address assigned by the 
linkage editor to the first byte of that record, plus the 
total length of the record. This information is used by 
program fetch to read the following text. 


Note: The control portion contains as many IDs and lengths 
as there are control sections in the following text record. 


Text for each control section. Text records contain the 
instructions and data for the module. In overlay, the 


linkage editor produces two special types of text records, 
the segment table (SEGTAB) and entry table CENTAB). 


SEGTAB, located in the root segment, is used by the overlay 
supervisor to keep track of the relationship of segments 
during execution. ENTAB is a separate control section that 
may be created by the linkage editor for each overlay 
segment. ENTAB is used by the overlay supervisor to 
determine the segment to be loaded when a segment not in the 
current path is referred to. 


A note list. A note list gives the location of each overlay 
segment in the output module library. 


If there are many RLD items for the previous text, there may 
be several RLD records preceding the next text record. The 
last of these is a control/RLD record. 

If there are no RLD items for the last text record, the 
control record that precedes the text contains the EOS or 
EOM indication. If there are RLD items, the EOS or EOM 
follows the text record (see Figure 3 on page 9). 
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Figure 4. Linkage Editor Processing for the Scatter Load and TEST Attribute 





Figure 4 shows the module structure when the scatter load and 
TEST attributes are requested. With these attributes, the 
output load module contains: 


e SYM records 
e A composite ESD 
e IDR records 


e A scatter/translation record used by program fetch to 
compute the relocated addresses required for scatter loading 
the module into storage. The record contains a scatter 
table and a translation table. The scatter table is a list 
of control section addresses; the translation table 
correlates the CESD entry for each control section with the 
address indicated in the scatter table. (When a load module 
in scatter format is processed again by the linkage editor, 
this information is ignored. ) 


° Text for each control section, preceded by a control or 
control/RLD record describing it. 


e RLD or control/RLD records containing any RLDs pertaining to 
the preceding text record. 


e An EOM indication that marks the end of the module. 


The appendix "Input Conventions and Record Formats” contains 
the format of each record type. 


Four data sets must be specified for linkage editor processing; 
their ddnames and functions are: 


1. SYSLIN. This is the "primary input data set,” containing 
object modules and control statements. All input from 
SYSLIN must be in 80-column card image format, unblocked or 
blocked from 1 to 40 records per block. The SYSLIN source 
may be a card reader, magnetic tape, a direct access device, 
or a concatenation of data sets from different types of 
input devices. 
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2. SYSPRINT. This is the "diagnostic output data set." 
Diagnostic messages as well as any diagnostic options 
requested, such as a module map or cross-reference table, 
are written on SYSPRINT. It is a sequential data set and 
may be partitioned. The SYSPRINT device may be a printer, 
magnetic tape, terminal, or a direct access device. 


3. SYSUT1. This is the “intermediate data set.” The linkage 
editor uses this data set for temporary storage of text and 
RLD items being processed. SYSUT1 must be ona 
direct-access volume. 


Note: SYSUT1 is opened only when twopass processing is in 
effect. 


4. SYSLMOD. This is the "output module data set." It is a 
partitioned data set on a direct-access volume. SYSLMOD 
contains load modules; their attributes are described in the 
user's portion of the directory entry for the member. 


Two additional data sets may be specified for linkage editor 
processing; their ddnames and functions are: 


e SYSTERM. This is the "terminal data set." Diagnostic 
messages are written on SYSTERM if the TERM option was 
specified. When the linkage editor is being executed in the 
time-sharing foreground, the SYSTERM device is always the 
terminal; when the linkage editor is being executed in the 
background, the SYSTERM device may be a printer, magnetic 
tape, or a direct-access device. 


e SYSLIB. This data set is used by the linkage editor if 
there are any automatic library calls to be processed. 
SYSLIB can be defined only as a partitioned data set (PDS). 
The members of SYSLIB can be either load modules or object 
modules (but object modules and load modules cannot be 
contained in the same PDS and a data set containing load 
modules cannot be concatenated with a data set containing 
object modules). 


When SYSLIB is opened, the linkage editor determines whether 
the PDS contains object or load modules by checking the 
record format field CRECEM) in the data control block (DCB). 
(The format is fixed (F) for object modules and undefined 
(CU) for load modules. Load module records are of variable 
length.) If SYSLIB contains object modules, the linkage 
editor ignores the user's portion of the PDS directory 
entries for the object modules. 


Other data sets may be read by linkage editor when it processes 
INCLUDE or LIBRARY statements specifying ddnames. Data sets 
referenced with INCLUDE statements may be either sequential or 
partitioned. SYSLIB and any data sets specified in LIBRARY 
statements for use by automatic library call must be 
partitioned. 


The attributes for the “execute linkage editor” job step are the 
attributes specified on the EXEC statement. These attributes 
may be modified if a load module having different attributes is 
processed. 


Figure 5 on page 13 shows the input/output flow. During the 
initial processing, SYSLIN, SYSPRINT, SYSLMOD, and SYSTERM Cif 
the TERM option was specified) are opened. During input 
processing, the primary input is read from SYSLIN. If an 
INCLUDE statement is read in the primary input, the data set 
whose ddname is specified on the statement is opened, and is 
processed. At the end of all SYSLIN input, SYSLIB and any other 
data sets whose ddnames are specified on LIBRARY statements are 
processed through automatic library calls. 
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If the TEST attribute has been selected, SYM records are written 
during input processing; text and RLD items are written 
sequentially on SYSUT1, except during single pass processing. 
The location of each text record on SYSUT1 is entered in a text 
note list. The location of each RLD record on SYSUTI1 is entered 
in a RLD note list. If either note list overflows, it is 
written out on SYSUT1. The RLD note list may overflow 3 times, 
the text note list may overflow 11 times. 


In intermediate processing, the CESD is written on SYSLMOD. If 
a scatter table, translation table, or SEGTAB is required, it is 
also written on SYSLMOD. The note list for the text and RLD 
items on SYSUT1 are read into storage. If a module map was 
required, the CESD is used in producing the map. If a 
cross-reference table was requested and all RLDs are in storage, 
the table is produced during intermediate processing. 


During second pass processing, 


text and RLD records are read 


into storage from SYSUT1 in the order of assigned addresses 
within each segment Cusing the note lists to find the records) 


and are written out on SYSLMOD. 


In final processing, the member name and any alias names are 
entered into the PDS directory entry for the output load module 
through the execution of the STOW macro instruction. If any 
coded diagnostic messages were written on SYSPRINT during 
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linkage editor processing, a diagnostic message directory 
containing error message text is written out on SYSPRINT. Ifa 
cross-reference table was requested and was not produced during 
intermediate processing. SYSLMOD is opened for input, RLDs are 
read, and the cross-reference table is produced. At the end of 
final processing, SYSLMOD is closed Cif it was opened for 
input). All other data sets are then closed and control is 
returned to the calling program, unless the SYSLIN input during 
input processing was terminated by a NAME statement. If a NAME 
statement terminated the primary input, control is returned to 
initial processing and SYSLMOD is opened for output, if it had 
been closed during final processing. 


When multiple load modules are produced in a single execution of 
the linkage editor, SYSLIN, SYSPRINT, and SYSUT1 remain open for 
the entire execution. (CA pointer in the DCB for SYSUT1 is 
repositioned to the beginning of the extent of SYSUT1 after each 
load module is produced.) If neither a module map nor a 
cross-reference table is requested, or if a cross-reference 
table is requested and all RLDs are in storage, SYSLMOD remains 
open for output for the entire linkage editor execution. 
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THOD OF OP TI0 


This section contains an introduction to the logic of the 
linkage editor, emphasizing the flow of primary data and control 
information through tables and buffers, and functional 
descriptions of its phases. 


LOGIC OF THE LINKAGE EDITOR 


Initialization 


Input Processing 


The linkage editor can be functionally divided into five phases: 


° Initialization 

° Input (first pass) processing 

° Intermediate (first pass) processing 
e Second pass processing 

° Final processing 


Operation diagrams at the end of this section illustrate the 
functional operation of the linkage editor. The shaded areas of 
the diagrams correspond to operations described in the text. 


When the linkage editor receives control from the job scheduler 
or a calling program, it performs initialization functions in 
preparation for all subsequent processing (see Diagram 3). The 
operations included in initialization are: 


e Build the all-purpose table CAPT) and enter addresses and 
descriptions of all other tables and buffers into it. 


Analyze the attributes and options passed by the calling 
program (specified by the programmer) and save them in the 
all-purpose table. 


° Initialize DCBs and open data sets to be used during linkage 
editor processing. 


e Allocate storage for all tables, buffers, and work areas to 
be used by linkage editor processing. 


When all initialization functions are completed, thea linkage 
editor is ready to accept input. 


All linkage editor input is processed initially during the first 
pass (see Diagram 4). Object modules from SYSLIN (primary input 
data set) are read into the SYSLIN buffer. Object modules from 
SYSLIB or a specified user's library (secondary input data sets) 
are read into the object module buffer. Text records in load 
modules from SYSLIB or a user's library are read into the input 
text buffer; all other load module records are read into the 
first pass RLD buffer. The various records that constitute 
these modules are processed as follows. 


Control Statements: These records, which may precede or follow 
object modules, contain information that is later used in symbol 
resolution and that specifies libraries containing secondary 
input. Depending on the type of control statement, entries are 
made in either the all-purpose table CAPT) or the composite 
external symbol dictionary (CESD). 
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ESD Records: These records from object modules, and CESD records 
from load modules, describe symbols that have been defined for 
external use. Entries for the symbols are made in the CESD. 

Entries are made in the renumbering table to allow the . 
translation of the input ESD identifiers (IDs) into new CESD 

IDs. Entries are made in the delink table for symbols that are 

to be deleted or replaced. 


TXT Records: These records, containing the instructions and data 
of the program, are moved from the SYSLIN buffer and object 
module buffer to the input text buffer (text records from load 
modules are read directly into the input text buffer). They are 
arranged in the proper sequence and recorded in the text 1/79 
table and the text note list. When the input text buffer is 
filled, its contents are written onto SYSUT1; if it does not 
become filled, text records are retained in the buffer, and 
"single pass" processing is in effect. Text note list entries 
contain the location of text records (SYSUT1 address or buffer 
address) and other descriptive information. Text I/0 table 
entries contain information identifying text records by ESD ID. 


RLD Records: These records, to be used later in relocating 
address constants, are moved from the SYSLIN buffer and object 
module buffer to the RLD buffer. The relocation and position 
pointers (R and P pointers) are updated, using control 
information from the renumbering table and the delink table. 
RLD items are examined and marked for future processing. If 
V-type (branch-type) address constants are found in overlay 
programs, entries are made in the call list for use during 
intermediate processing. When the RLD buffer is full, RLD 
records are written on SYSUTI1, and control information 
identifying RLD records by size (byte count), P pointer, and 
location on SYSUT1 is entered in the RLD note list. If the RLD 
buffer does not become filled, RLD records are retained in the 
buffer and single pass processing is in effect. 


SYM Records: These records, which are not involved in linkage 
editor processing, are gathered in the RLD buffer and are 


written directly on SYSLMOD, if the TEST attribute has been 
specified. If TEST has not been specified, SYM records are 
ignored. 


IDR Records: These records, which contain data either from an 
input load module or from an END record or from the linkage 
editor IDENTIFY control statement, supply information concerning 
the processing history of the modules in which the IDRs occur. 
If the data is from an input load module, control is passed to 
the IDR processor HEWLFIDR. If the data is from an END record, 
the data refers to the compiler that created the object module. 
The compiler or translator data is passed in a parameter list to 
the IDR processor. The user data, supplied via the linkage 
editor IDENTIFY control statement, is converted into a parameter 
list and passed to the IDR processor. 


When all input records have been processed (all external symbols 
have been entered into the CESD), control is passed to 
intermediate processing. 


Intermediate Processing 


The operations included in intermediate processing (see Diagram 
5) have two primary objectives: (1) to assign relative storage 
addresses to symbols in the CESD, and (2) to write some of the 
records to be included in the output load module on the SYSLMOD 
data set. The MAP and XREF options may also be processed during 
intermediate processing. 


Address Assignment: Entries that require no further processing 

are deleted from the CESD; all other CESD symbols are assigned 
temporary linked addresses. Relocation constants are determined 

for all control sections, and the relocation consta able ) 





CRCT) is built. 
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For all programs in overlay, additional processing is required. 
The calls list is used to determine ENTAB entries to be placed 
in the CESD, and the downward calls list is built. The segment 
length table (CSEGLGTH) is built, and segment relocation 
constants are computed. Temporary linked addresses in the CESD 
and entries in the relocation constants are computed. Temporary 
linked addresses in the CESD and entries in the relocation 
constant table are adjusted for overlay by adding to them the 
segment relocation constants. 


Temporary linked addresses and relocation constants are combined 
to determine final linked addresses for symbols, and the results 
are placed in the CESD. The alias table is built from alias 
symbols in the CESD. At this point, CESD processing is 
complete. 


MAP/XREF Processing: If the MAP option has been specified, a 
module map, containing sorted CESD items, is built and written 
on SYSPRINT. If the XREF option has been specified and all RLDs 
are in storage, a cross-reference table is built from RLDs Cin 
the RLD buffer) and written on SYSPRINT. If all RLDs are not in 
storage, the cross-reference table is not built, but is deferred 
until final processing. 


Intermediate Output: The principal function of this section of 
intermediate processing is to write the CESD on the output load 
module data set (SYSLMOD). The half ESD CHESD), containing 
control information from CESD entries, is built and held in 
storage for use during second pass processing. The text ]/0 
table is reorganized according to the sequence in the order 
table and scanned to determine the ID of the last control 
section containing text in the program (Cor in each segment of an 
overlay program); this information is placed in the high ID 
table CHIID), and noted in the HESD for use during second pass 
processing. 


For a program in overlay, the segment table (SEGTAB), which 
defines the relationships among segments, is built and written 
(with a control record) on SYSLMOD. 


For a program that is to be scatter loaded in the OS environment 
(MFT or MVT), a scatter table and a translation table are built 
from information in the CESD, and scatter/translation records 
are written on SYSLMOD. 


The IDRs are written out on the output load module data set 
CSYSLMOD). 


Second Pass Processing 


The objectives of second pass processing (see Diagram 6) are 
relocating address constants in the text and writing on the 
SYSLMOD data set the remaining records that constitute the 
output load module. 


Text records are read from SYSUT1 Cintermediate data set) into 
the second pass text buffer, using the text I/0 table and the 
text note list to locate the records on SYSUT1. The text I/0 
table is also used to determine the order in which text records 
are to be processed. RLD records associated with the text being 
processed are read into the second pass RLD input buffer, using 
the RLD notelist to locate the required records. 


Single Pass Processing: If the linkage editor did not write text 
or RLD records on SYSUT1, single pass processing is in effect 
for these records. The records are accessed directly in the 
input text buffer and the RLD buffer, which are physically the 
same storage areas as the second pass RLD input buffer. If text 
records or RLD records were written on SYSUTI1, they are read 
back into the same locations. 


Relocation: Address constants described by RLD items are moved 
from the second pass text buffer to a work area, where 
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Final Processing 


relocation is performed. The manner in which each address 
constant is relocated depends on whether it is a V-type 
(branch-type) or an A-type (nonbranch-type) address constant, or 
a pseudo register (type 1 or type 2) 


The V-type address constant can refer to a named location in 
some other control section (branch type address constant). The 
value field of such a V-type address constant always contains a 
zero because the address was not known at compilation time. 
During second pass processing, the linkage editor address 
Cabsolute relocation factor) that was assigned to the symbol and 
saved in the HESD is inserted in the value field. This is 
called absolute relocation. 


If the V-type address constant is in an overlay program, the 
address of an ENTAB entry for the symbol and the segment number 
of the current text is inserted in the value field. (CENTABs are 
created in the second pass RLD buffer from information in the 
HESD and the entry list, which contains an entry for each V-type 
address constant in the path of a referred-to symbol.) 


The value field of an A-type address constant that refers to a 
named location in the same input module (nonbranch-type address 
constant) contains an address assigned by the language 
translator. During second pass processing, this address is 
modified by adding or subtracting the relative relocation factor 
that was determined for the symbol referred to by the address 
constant. Relative relocation factors area saved in the 
relocation constant table. This process is called relative 


relocation. 


When each address constant is relocated, it is placed back in 
the text, and the address field of the associated RLD item is 
updated. The RLD item is then moved to the second pass RLD 
output buffer. When all address constants in the text buffer 
are relocated, the text is written on SYSLMOD, followed by the 
associated RLD items. A control record pertaining to the next 
text record is written on SYSLMOD following the RLD recone es If 
the output load module is structured for overlays, a IIR list, 
containing the address of the first control record of each 
segment (for the first segment, the list contains the address of 
the first text record), is also created and retained in virtual 
storage. 





Second pass processing continues until all segments in the 
output module are processed. The last control record contains 
end of module indicators. Control is then passed to final 
processing. 


The objectives of final processing (see Diagram 7) include 
writing remaining output to SYSLMOD, producing certain optional 
output, and “cleanup” functions. 


The partitioned data set directory for SYSLMOD is completed, 
including modifications for ALIAS symbols (found in the ALIAS 
table), and a STOW macro is issued. The TTR list, containing 
the address of the first text record in each segment, is written 
on SYSLMOD for overlay programs. 


The error logging map, produced as errors are encountered 
throughout linkage editor processing, 18 scanned and an er 
diagnostic directory is built and written on SYSPRINT. If the 
TERM option was specified, the error diagnostic directory is 
also written on SYSTERM. Storage allocated to the linkage 
editor is released. 


If the XREF option is specified and was not processed during 
intermediate processing, RLD records are read from SYSLMOD, and 
a cross-reference table is built and written on SYSPRINT. 
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INITIALIZATION 


At the completion of linkage editor processing, control is 
returned to the calling program. 


The initialization phase comprises modules HEWLFINT, HEWLFOPT, 
and HEWLFDEF. 


When the linkage editor begins processing, it readies the 
all-purpose table, analyzes control information, opens necessary 
data sets, and allocates space to buffers and tables. 


PREPARING THE ALL-PURPOSE TABLE (CAPT) 


The linkage editor maintains the all-purpose table as the common 
communication area for all internal functions (see Figure 27 for 
the contents of the all-purpose table). The basic information 
in the all-purpose table is added to during initialization as 
operating conditions are learned. This information includes the 
results of the control information analysis and descriptions of 
the tables and buffers built by the linkage editor. 


ANALYZING CONTROL INFORMATION 


When the linkage editor receives control from the job scheduler, 
or from another program via a CALL macro instruction, control 
information may be passed to it. This information includes the 
options that control linkage editor processing and the 
attributes to be assigned to the output load module. A calling 
program may also provide a substitute list of ddnames to be used 
in place of the standard names, and a PDS directory name for the 
output load module. 


During initialization, the specified attributes and options are 
interpreted, checked for validity against an attribute-option 
table, and recorded in the all-purpose table. When options with 
associated values are recognized, the linkage editor also saves 
the value in the all-purpose table. (For example, the SIZE 
option gives user-chosen values to be used instead of the 
default values.) 


Besides being checked for valid specification, the attributes 
and options are also checked to ensure that they are requested 
only in allowable conbinations. When mutually exclusive 
attributes or options are noted, the dominant attribute or 
option is retained; the other is ignored (see Figure 6 on page 
20). 


IDR Records: These records, which contain data either from an 


input load module, from an END record, or from the linkage 
editor IDENTIFY control statement, supply information concerning 
the processing history of the modules in which they occur. If 
the data is from an input load module, control is passed to the 
IDR processor, HEWLFIDR. If the data is from an END record, the 
data refers to the compiler that created the object module. The 
compiler or translator data is passed in a parameter list to the 
IDR processor. The user data supplied via the linkage editor 
IDENTIFY control statement is converted into a parameter list 
and passed to the IDR processor. 
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OPENING DATA SETS 
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Note: An X indicates incompatible attributes; the attribute that appears lower on the list is 
ignored. For example. to check the compatibility of XREF and NE, follow the XREF column 
down and the NE row across until they intersect. Because an X appears where they intersect, 


they are incompatible attributes. NE is ignored. 


Figure 6. Incompatible Module Attributes and Program Options 


After the standard ddnames (Cor passed ddnames) have been entered 
into the proper DCBs, the data sets always required for linkage 
editor operation are opened. These are the SYSLIN, SYSPRINT, 
and SYSLMOD data sets. If the TERM option was specified, the 
SYSTERM data set is also opened. 


Note: SYSLIB is opened during input 
library calls or INCLUDE statements are recognized. 
opened only for twopass processing. 


processing if automatic 
SYSUT1 is 


When SYSLIN is opened, the "unlike attributes” indicator in the 
associated DCB is set to signify that SYSLIN may be a 
concatenation of data sets with varying blocking factors. 


In preparation for the opening of the SYSLMOD data set, the 
linkage editor obtains storage for the JFCB for the data set and 
reads the JFCB into that storage. From the JFCB, the linkage 
editor obtains the data set disposition and the block size, in 
case the DCBS option is specified. The block size in the JFCB 
1S zeroed in order to obtain the DSCB block size when the data 
set 1S opened. 


In addition, a DEVTYPE macro instruction is issued to obtain the 
maximum block size for the type of device on which the SYSLMOD 
data set resides. The value obtained will be used subsequently 
in determining the output block size. 
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If the SYSLMOD data set resides on a shared device and if the 
data set is not a temporary data set, the linkage editor 
reserves the shared device for the duration of the job step. If 
the SYSLMOD data set does not reside on a shared device but a 
disposition of SHR was specified for it on the SYSLMOD DD 
statement, the linkage editor enqueues the SYSLMOD data set for 
the duration of the job step. 


The SYSLMOD data set is opened with an OPENJ macro instruction, 
specifying the JFCB previously read and modified. 


During the opening of the SYSLMOD data set, the block size to be 
used for output to the data set is determined in the open exit 
routine. The appropriate block size is selected considering the 
following factors: The value obtained from the DEVTYPE macro 
instruction, establishing the absolute maximum block size; the 
block size in the DSCB for an existing data set, which can be 
increased but not decreased; the block size from the SYSLMOD DD 
statement, when the DCBS option is used; the implied maximum 
block size of 1024, when the DC option is used; the implied 
minimum block size of 1024, when the SCTR option is used; the 
absolute minimum block size of 256. 


ALLOCATING VIRTUAL STORAGE 


Buffer Allocation 


Table Allocation 


To obtain storage for buffers and tables, the linkage editor 
issues the GETMAIN macro instruction specifying the minimum 
amount of additional virtual storage required for operation. 
The minimum provides for overlay or hierarchy tables if these 
options are selected, and, for an area, a 12K-byte block of 
storage that is returned by means of a FREEMAIN macro 
instruction, for use by system and data management functions. 
The minimum also includes the added space required for the 
primary input buffer when the SYSLIN data set contains blocked 
records. If the minimum is not available, control is not 
returned to the linkage editor; instead, a system abnormal 
termination occurs. 


When the supervisor returns virtual storage space, the linkage 
editor determines whether the area is sufficient to use maximum 
lengths for the SYSLIN, SYSPRINT, and object module buffers. If 
the space is not sufficient, intermediate or, when necessary, 
minimum buffer lengths are used. 


The RLD and text buffers are then assigned storage. The default 
text buffer length (48K bytes) is used unless a specific 
allocation was requested via the SIZE parameter. The RLD buffer 
is also assigned the minimum length unless the SIZE parameter 
allows it to be given additional space. In this case, the 
increased length depends on the amount of storage remaining 
after the text buffer has been allocated. 


Note: Space allocated for buffers is not released until linkage 
editor processing is completed. 


Following buffer allocation, the linkage editor assigns storage 
to its fixed-length and variable-length tables. In initial 
allocation, the linkage editor determines the minimum storage 
required by each table. The size of each table and the number 
of entries in each table are saved in the all-purpose table. 


Storage is then reallocated. The storage in excess of the 
minimum required for all the tables is determined. The excess 
is used to expand proportionately the variable-length tables. 
Then, the size of each table and the number of entries per table 
are calculated. This information and the newly assigned table 
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addresses are saved in the all-purpose table. When all linkage 
editor processing is completed, all table space is released. 


INPUT PROCESSING > 


The input processing phase comprises modules HEWLFINP, HEWLFINC, 
TEUEE ERS HEWLFESD, HEWLFSYM, HEWLFRAT, HEWLFEND, HEWLFIDR, and 


The operations performed during input processing depend on the 
nature of the input; special processing is required for each 
input record type. Each input record is read, using one of two 
read blocks. The first read control block contains the address 
of the SYSLIN buffer; the address of the SYSLIN DCB, and the 
block size and logical record length. The second read control 
block contains the address of the buffer for library records 
Cobject module buffer or load module buffers), the address of 
the library DCB, and the block size and logical record length. 
A pointer is used to indicate which read control block is to be 
used for the input record. Initially, the pointer is set to the 
SYSLIN read control block. 


The type of input processing required is determined by the 
following conditions: 


e For all object module records whose first column character 
is a blank, control statement scanning is required, provided 
that the record is not encountered "in module.” (Control 
statements encountered within a module cause an error 
indication.) 


e Either object module processing or load module processing is 
required, depending on the type of input module. Only 
object modules are read from SYSLIN. Input modules from 
libraries are identified by record format. (Fixed format 
CF) indicates object modules; undefined format (U) indicates 


load modules. ) 
° When an INCLUDE control statement is detected during normal . 
processing, “include” processing is initiated. At 
end-of-input from the specified include library, normal 
processing resumes. If an INCLUDE control statement is 
detected during “include™ processing, “include” processing 
is reinitiated for the new include library. 


e At end-of-input from SYSLIN, automatic library call 
processing is required if the NCAL option (no automatic 
library calls) was not selected. If the NCAL option was 
selected, input processing is complete. 


e At end-of-input from SYSLIB during automatic library call 
processing, automatic library call processing is 
reinitiated. 


e If a NAME statement, which may indicate a multiple execution 
of the linkage editor, is detected during control statement 
scanning, processing proceeds as if an end-of-input has 
occurred on SYSLIN Cautomatic library call processing is 
performed). 


e If an end-of~-input occurs on SYSLIN but no valid input was 
received, linkage editor processing is terminated. 
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Reading Blocked Input 


The linkage editor can accept blocked card image input from the 
SYSLIN data set and blocked object module records from the 
SYSLIB data set Cor from a user's library). Generally, the 
record format, block size, and logical record length are 
established either when the data set is created, or when they 
are specified on the DD statement for the data set in an 
execution of the linkage editor. If the BLKSIZE field is not 
specified, the linkage editor assumes a block size of 80. The 
logical record length (LRECL) is fixed at 80. 


If the block size specified on primary input exceeds the 
allowable maximum or is not a multiple of the logical record 
length, an error message (IEW0594) is issued and linkage editor 
processing is terminated; if the invalid block size is specified 
on input from a library, the data set is ignored, but processing 
is not terminated. The block size specified by the user is used 
as the read count; if a short block is read, the linkage editor 
determines (via an exit at SYNAD) whether the length of the 
short block is valid (a multiple of the logical record length) 
and the number of the logical records it contains. 


If SYSLIN is a concatenation of data sets, the input processor 
reexamines the block size fields whenever a data set boundary is 
crossed to determine whether their values have changed. 


Record Lengths for SYSPRINT 


In determining record lengths for SYSPRINT, the linkage editor 
first checks the block size unless time sharing is in effect. 

If the BLKSIZE is not specified by the user, it is set equal to 
121. If the block size exceeds the allowable maximum or is not 
an integral multiple of 121, linkage editor processing is 
terminated and a condition code of 16 is returned. If the block 
size is a multiple of 121, it is not changed and the logical 
record length for output to SYSPRINT is set equal to 121. 


If time sharing is in effect, both the block size and the 
logical record length for SYSPRINT are set equal to 81. When 
the linkage editor is being executed in the time-sharing 
foreground, header messages are printed only once and all 
line-counting functions are ignored. 


Note: If SYSPRINT is a member of a partitioned data set and the 
DSCB is changed (by setting the logical record length or 
changing the block size), it may be impossible to use the 
information in the other members of the PDS. 


Record Lengths for SYSTERM 


Control Statement 


The block size and the logical record length for output to 
SYSTERM are set equal to 121 unless time sharing is in effect. 
If time sharing is in effect, the block size and the logical 
record length are set equal to 81. 


Note: If SYSTERM is a member of a partitioned data set and the 
DSCB is changed (by setting the logical record length or 
changing the block size), it may be impossible to use the 
information in the other members of the PDS. 


When an input record is found to be a control statement (a blank 
in column 1), it is scanned to detect format errors and 
continuation of comments or operands. A vector table is scanned 
to determine the appropriate processor; separate processing is 
required for each type of control statement CINCLUDE, REPLACE, 
LIBRARY, CHANGE, INSERT, OVERLAY, ENTRY, ALIAS, NAME, SETSSI, 
IDENTIFY, HIARCHY, ORDER, PAGE, SETCODE, EXPAND, and MODE). 
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Diagram 8 illustrates general processing of each control 
statement type. 


shown in Figure 7. The control statement scanner interprets 
symbols enclosed in parentheses as "level 1" symbols; symbols 
not enclosed within parentheses are "level 0." ENTRY, ALIAS, 
INSERT, HIARCHY, SETSSI, and PAGE control statement operands 
contain only level 0 symbols. CHANGE, IDENTIFY, SETCODE, 
EXPAND, and MODE statement operands always contain both a level 
0 symbol anda level 1 symbol. 


The general format for linkage editor control statements is ) 








Operation Operand 
OPRTIONX ; res a ee Sasa ct 





Pl P] Pl Pl Pl Before Read 8 
Processing 
ee ee After Read® 
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OPDO OPD1 


io 
OPDO OPD1 


OPDO OPD1 


Figure 7. Control Statement Scanner Operation 





The operands of REPLACE, INCLUDE, OVERLAY, NAME, and ORDER 
control statements contain level 0 symbols, or both level 0 and 
level 1 symbols. LIBRARY statement operands may contain level 
1, or both level 0 and level 1 symbols. The operation to be 
performed depends on the operand format. 


The control statement scanner searches a vector table for the 
operation symbol to determine the associated control statement 
processor. It then analyzes the operands using two work areas, 
"OPD1" and “"OPDO", and two pointers, "P1™" and "P2". OPD1 is 
used for level 1 operand symbols; OPDO is for level 0 operand 
symbols. Pl points to the operand symbol being analyzed; P2 
points to either OPDO or OPD1, depending on the level of the 
operand symbol referred to by Pl. 


An operand symbol referred to by Pl is placed by the READ8& ) 


routine into the work area referred to by P2. Parentheses and 
commas control the switching of pointer P2 between the work 
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areas. For example, when a left parenthesis is encountered, P2 
moves to OPDI1 because a level 1 operand symbol will follow. 
When a comma, blank, or right parenthesis is detected, the 
PROCENTY routine passes control to the control statement 
processor that was previously found during the search of the 
vector table. 


When an IDENTIFY control statement is read by the control 
statement processor, a switch is set on for the special string 
option utilized by IDENTIFY. When the switch in the control 
statement processor is picked up by the READ8 routine, it sets 
another switch, permitting up to 40 characters to appear in the 
IDENTIFY operand. This allows any character, including embedded 
blanks, to appear between single quotation marks. 


Control Statement Processors 


When the operand symbols have been read into work areas OPDO and 
OPD1, control is passed to the control statement processor at 
the saved entry point. Scanning of the control statement 
resumes when the control statement processor returns control. 
The individual control statement processors are described in the 
following paragraphs. 





CESD 
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Chain ID Length/ID 
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Figure 8. INCLUDE Statement Processing for a Sequential Data Set 
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INCLUDE STATEMENT PROCESSOR: The INCLUDE statement processor 
builds a chain in the CESD of items to be included. Each item 
in the chain contains the address of the next item in the chain 
Cin the chain/address field—bytes 9, 10, and 11). The last 
item in the chain contains zeros in this field. 


Chained include items have two kinds of subtypes: "include with 
pointer” and "include without pointer.” In Figure 8, the 
statement INCLUDE M defines M as a sequential data set. The 
INCLUDE statement processor creates an entry for the ddname M in 
the CESD with the subtype "include without pointer.” 


In the statement INCLUDE LIBX (A), A is defined as a member of a 
PDS. The INCLUDE statement processor creates an entry for A in 
the CESD with the subtype "include with pointer." The pointer 
is in the chain pointer/chain ID field (bytes 14 and 15); it 
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contains the CESD line number of the ddname LIBX. A single 
ddname, such as LIBX, may be referred to by several pointers. 


Figure 9 describes INCLUDE statement processing with nested 
members. ) 





Librory 
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Figure 9. INCLUDE Statement Processing With Nested Members 
® The statement INCLUDE TEMP (CA, B, C) indicates that A, B, 


and C are members to be included from library TEMP. 


e Member B contains the nested statement INCLUDE LIBX (CU, V, 
Wd; this is the last statement processed in member B. 
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e The CESD is shown at the time when the control statement 
scanner has read operand V, but not W. The INCLUDE 
statement processor has created a CESD line for operand V in 
the LIBX include chain. C is currently the last item in the 
TEMP include chain. When the control statement scanner 
reads operand W, the INCLUDE statement processor enters a 
CESD line for W between V and C; this process is distinct 
from the one that actually searches the members U, V, and C 
on the library (see "INCLUDE Processing™). 


At the time chosen for this example, the data set member B is 
being read; data set member A has been read and therefore is no 
longer in the CESD as a member name, but data set members U, V, 
and C have not yet been read. 


The chained CESD entries created by the INCLUDE statement 
processor are later processed by the include processor. > 
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Legend: 


* In this example, card OVERLAY C has just been read. Name B is 
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OVERLAY STATEMENT PROCESSOR: The OVERLAY statement processor 
maintains a record of the current segment number and updates it 
by one each time a new OVERLAY statement is encountered. The 
relationship of segments in an overlay tree structure is kept in 
the segment path table (SEGTA1) (see Figure 10). Entry niin 
SEGTA1 contains the number of the segment that precedes the nth 
segment of the overlay tree structure (the next higher segment 
in its path). The OVERLAY statement processor creates a chain 
of overlay items in the CESD and updates SEGTAL. If the level 1 
operand CREGION) is detected, the current region number is 
incremented by one, and a zero is entered as the previous 
segment number in SEGTA1. 
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Overlay Statement Processing 





If an OVERLAY statement is encountered that refers to a node 
point higher in the overlay tree structure, all symbols 
identifying node points higher in the path are removed from the 
chain; their CESD lines are marked "null." For example, in 
Figure 10, when the statement OVERLAY A is encountered after 
segment 4, the CESD entry for symbol B is marked null and is no 
longer in the chain. If an OVERLAY B statement was encountered 
at the end of segment 5,» a new node point would be established 
for B, and symbol B would again be entered in the CESD. 


HIARCHY STATEMENT PROCESSOR: The HIARCHY routine first 
determines if the hierarchy number is valid. If it is invalid, 
the statement is printed; an error message is written and the 
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remainder of the statement is ignored. If the number is valid, 
it is converted to binary and saved for the SCAN routine. 


Processing of the statement continues with the collection of the 
next symbol, up to a comma or a blank. The CESD is searched for 
this symbol; the location in the hierarchy table corresponding 
to this CESD item is set to the hierarchy number specified. 

(The hierarchy table is built during initialization if HIAR was 
specified. The hierarchy table consists of one byte per entry 
in a one-to-one correspondence with the number of items 
allocated to the CESD. The address of this table is kept ina 
fullword in the all-purpose table.) 


If the symbol does not appear in the CESD, the symbol is entered 
in an unused entry in the CESD, marked external reference, and 
the hierarchy number is stored in the corresponding entry in the 
hierarchy table. This procedure is repeated for each additional 
symbol in the HIARCHY statement. 


The intermediate output routine uses the hierarchy table to 
place the hierarchy number associated with each CESD item in the 
scatter/translation table. 


INSERT STATEMENT PROCESSOR: The insert statement processor scans 
the CESD for the symbol indicated in the INSERT statement. If 
the symbol is found, the segment number field is changed to the 
number of the segment that contains the INSERT statement. If 
the symbol is not found in the CESD, a new ER entry in the CESD 
is created. In either case, the CESD entry is marked "insert" 
in the subtype field, and the segment number of the INSERT 
statement is placed in the segment number field. 


REPLACE AND CHANGE STATEMENT PROCESSORS: The REPLACE and CHANGE 
statement processors build a chain of CESD entries. Each entry 
to be replaced, changed, or deleted is so marked in the subtype 
field. The ESD processor examines the replace/change chain 
before processing any ESD item. Because a REPLACE or CHANGE 
statement applies only to the module that immediately follows it 
in the input, the replace/change chain is removed from the CESD 
at the end of the module. 


When a REPLACE statement or a CHANGE statement operand contains 
two symbols, such as CHANGE A (B), A and B are entered in 
consecutive lines of the CESD. Only the first line of the pair 
(the line for A) contains the address Cin the chain address 
field) of the next item in the replace/change chain. 


NAME STATEMENT PROCESSOR: The NAME statement processor places an 
entry in the all-purpose table containing the name under which 
the output load module is to be stowed in the PDS directory. If 
the operand contains the level 1 symbol (R), a bit is set to 
indicate that the module is to be stowed as a replacement for a 
module of the same name. Another bit is set to indicate that a 
NAME statement was encountered; the input processor tests this 
indicator and terminates input operations if it is set. Ifa 
NAME statement is received from any input source other than 
SYSLIN, the error routine is entered; NAME statements are 
accepted only if they are in the primary input. 


SETSSI STATEMENT PROCESSOR: The SETSSI statement processor 
converts the 8 bytes of hexadecimal information specified on a 
SETSSI statement to a 4-byte field, and enters it into the 
all-purpose table. During final processing, this information is 
entered into the system status index, a 4-byte extension of the 
user data area in the PDS directory. The index contains 
information describing the status of members in the library and 
is used for maintenance purposes. 


ORDER AND PAGE STATEMENT PROCESSOR: The ORDER and PAGE statement 
processor builds the ORDER table. First, the CESD is searched 
for a match to the symbol specified in the ORDER or PAGE 
statement. If the symbol is not found in the CESD, the symbol 
is entered into the CESD as a "weak external" reference CWX). 
The ESD identifier of the CESD line is entered into the ORDER 
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table. When a matching symbol is found in the CESD, and the 
entry is not a control type ER, the ID of the CESD line is 
entered into the ORDER table. 


The appropriate flags are set in the ORDER table entry to 
indicate if the specified request is either an ORDER or a PAGE 
statement. The ORDER flags are set when text ordering during 
output processing is requested. The PAGE flags specify that the 
linkage editor is to perform page alignment during address 
assignment. The ORDER flags can be set only when an ORDER 
control statement is present. The PAGE flags can be set in one 
of two ways: (1) if P is specified on an ORDER control 
statement, or (2) if the PAGE control statement is present. See 
Figure ll for an example of order and page processing. 





CESD 


Chn Addr/ Sub | Chn Pointer 
Symbol |Type| Reverse Type| Chain 
Chain ID Length/ID 
® 


CSECTA | 02 | 0000 00 
e 

CSECTC 0000 

CSECTB 0000 
e 









PAGE CSECTB Entry Created 
ORDER 


CSECTA, | vee Fou ne 
CSECTC(P) ntry Create 















ORDER TABLE 


10 }0006 _| 







eS mmm i eee eee ea ei 





Figure 11. Order and Page Processing 


Note: In this example, CSECTB must follow CSECTA and CSECTC in 
the order table. Ordering was not specified for CSECTB. 


IDENTIFY STATEMENT PROCESSOR: The IDENTIFY statement processor 
picks up the CSECT name from OPDO, the length of the special 
string SPECSTR extracted by the READ8 routine, and the identify 
data placed in SPECSTR by the READ8 routine. This information 
1s placed in storage, and parameters and control are passed to 
the IDR processor HEWLMIDR at the entry point HEWLCIDR. 


ENTRY STATEMENT PROCESSOR: The ENTRY statement processor places 
the symbol specified in an ENTRY statement in the all-purpose 
table. The symbol will override any symbol specified in an END 
statement as the entry point for the module. 


ALIAS STATEMENT PROCESSOR: The ALIAS statement processor creates 
chained CESD entries for a maximum of 16 alias names specified 
in ALIAS statements. During address assignment, these entries 
are used to build the alias table. 


LIBRARY STATEMENT PROCESSOR: The LIBRARY statement processor 


creates chained CESD entries for the operands specified in 
LIBRARY statements; a chain is created for each distinct 
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library. Each chain begins with a library ddname and contains 
all member names specified for the library (see Figure 12 ). 


A member name specified in a LIBRARY statement can result in one 
of two kinds of ER subtypes: "matched library member” or 
"unmatched library member.” If a CESD entry is created for a 
member name specified in an input ER and also specified in a 
LIBRARY statement, it is called a "matched library member." 
However, if the member name was specified only in a LIBRARY 
statement, the entry subtype is "unmatched library member." 





Register 2 All Purpose Table 












LIBRARY LIB] (MARY) 
LIBRARY LIB2 (SAM, PETE) 
LIBRARY LIB] (JOE) 











Chn Addr s Sub Chn Pointer 
Symbol | Type | Reverse oe Chain 
Chain ID o | TYP® | Length AD 





Diagram A Diagram B 


Chn Adar b 
Symbol | Type | /Reverse = 
Chain ID | °° |" YP® 


Legend: 
@ The CESD shown in diagram B results from the CESD shown in diagram A ofter 
reading in three library cards, A chain with direct and reverse pointers is 
created for LIBI and also for LIB2. 








Chn Pointer 
Chain 
Length/ID 







@ JOE and PETE were ERs (subtype 00) and became "matched library member" 
(subtype 03), 





@ SAM and MARY were not previously in the CESD. They are created as "unmatched 
library member" (subtype 02). 


@ The CESD shown in diagram C results from the CESD shown in diagram B after 
reading in an input module containing the ER MARY and the SD JOE. (Only the 
library chains are shown), 


@ JOE is removed from the chain in diagram C, and the chain pointers are modified. 


®@ MARY becomes a "matched" subtype and will be called by the automatic 
library call processor (unless resolved by other input). 


@ SAM remains "unmatched" and will be ignored by the automatic library call 
Diagram C processor (unless matched in other input). 


Figure 12. Library Statement Processing 





EXPAND STATEMENT PROCESSOR: The EXPAND statement processor 
accumulates the expansion length specified and, if necessary, 
limits that length to 4095 bytes. If the name specified matches 
the name of a named control section or common section, the 
length of that control section or common section is updated by 
the expansion length in the matching CESD entry. A special 
entry is then made to the text processor to create and save text 
of the expansion length to be added to the control section or 
common section. 
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MODE STATEMENT PROCESSOR: The MODE statement processor verifies 


that the valid mode keywords, 
that the valid mode specifications are used-~24;, 
24 or ANY for RMODE. 


AMODE; 


AMODE and RMODE, are specified and 


31, or ANY for 


Appropriate values are set in the 


all-purpose table to indicate the mode(s) specified. 


SETCODE STATEMENT PROCESSOR: The SETCODE statement processor 
accumulates the authorization code specified. 


digits specifying a value of 0 


verified, 
table. 


Object Module Processing 


to 255 is imposed. 
the authorization code is saved in the all-purpose 


A limit of 8 


Once 


If input to be read by the linkage editor consists of object 


modules (fixed (F) record format indicates object modules), 


following operations are performed: 


° Determine record type 


° Set up general registers 


e Perform special event processing 


The record type is determined by examining columns 2 through 4 


of each logical input record. 
IDR, 


TXT, RLD, 


END), 


For each record type (SYM, 
special processing is required. 


ESD, 


The general registers are loaded with input record information 


to be used in the required processing, 
Figure 13. 


Assigned 


address of 
first byte of 
text 


Absolute 
address of 
entry point 
on END record 


SYM record byte 
count 


Number of bytes 
of ESD 
information 


Number of bytes 
of text 
information 


Number of bytes 
of RLD 
information 


Length of CSECT 
for which no 
length was 
given in ESD 
item 


ESD ID of first 
ESD item on 
record 


ESD ID of CSECT 
to which text 
belongs 


ESD ID CSECT 
containing 
entry point 


Figure 13. General Register Information——-Object Module Processing 


as described in 


Address of SYM 
record in 
buffer 


Address of 
first byte of 
ESD in buffer 


Address of 
first byte of 
text in buffer 


Address of 
first byte of 
RLD in buffer 
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Following is a description of special event processing: 


Load Module Processing 


When end-of-input is detected, any data still contained in 
the input RLD buffer or the input text buffer is written out 
on SYSUTI1, if necessary. 


See the appendix "Input Convention and Record Formats." 


If the TEST attribute is selected, the SYM records from the 
object module are blocked 3-to-1l in the input RLD buffer and 
written out on SYSLMOD. When the first TXT record in a 
module is encountered (or, if no text record has been 
encountered, when the END record is detected), remaining SYM 
records in the input RLD buffer are written out on SYSLMOD. 


When processing of an ESD record is completed, indicators in 
the all-purpose table are examined to determine if: 


_ A control section (SD, PC, or common) was indicated on 
the ESD record. 


- The TEST attribute was specified. 


If both conditions are met, the ESD record is blocked 3-to-l 
in the input RLD buffer and written out on SYSLMOD. 


If a control statement continuation is expected and an 
object module record is read, an error condition occurs, and 
a coded diagnostic message is produced. Normal object 
module processing is then performed on the record. 


If, during object module processing, a record is encountered 
that is not one of the six acceptable types (SYM, ESD, TXT, 
RLD, IDR, or END), an error condition occurs and a 
diagnostic message is produced. The input record is then 
ignored. 


Load modules included as input to the linkage editor are 
processed in the following manner: 


The input record type is determined by an identification 
field (byte 1 of the record), as shown in Figure 14 on page 
33. Special processing is performed for each record type. 


The parameter registers are loaded with input record 
information to be used in the required processing, as 
described in Figure 15 on page 33. 


If the record is not identified as a TXT, CESD, 

IDR, scatter/translation, SYM, or CTL/RLD record, an error 
condition occurs, and a diagnostic message is printed out. 
The input record is otherwise ignored. 


If the TEST attribute was not specified, all SYM records are 
1gnored. 


If an end-of-module indication is found in a CTL or RLD 
record, cleanup functions are performed. 


When a CTL record is detected, the following TXT record is 
immediately read into the input text buffer if it is not to 
be deleted. 


If the TEST attribute was specified and a SYM record is 
received, the record is written out as text translation data 
from the RLD input buffer. 
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Record Type (in Hexadecimal ) 
Identified by 
preceding control 
record 















If end-of-segment indicator is on: 


rep 


If end-of-module indicator is on: 





C a OC 





Figure 14. Input Record Types—Load Module 


Byte count of ESD ID of first Address of 

ESD items in CESD item on first byte of 

record record CESD item in 
buffer 


CTL CTXT) Assigned Number of ESD ID CSECT to 
address of entries in which text 
first byte of ID-length list belongs 
text 
RLD Byte count of Address of 
RLD items in first RLD item 
record in buffer 


Figure 15. General Register Information—Load Module Processing 
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The following describes the special processing performed, during 
object and load module processing, for the ESD, IDR, TXT,» RLD, 
and END records. 
J 


ESD Record Types 


Every object module in the input to the linkage editor must 
contain at least one ESD item. An ESD item is created by a 
language translator whenever it finds a symbol that is defined 
for external use. An ESD item is created to define the 
beginning of each control section, common areas, entry point 
names, and external references. Each ESD item has a type 
assigned to it that indicates its function. The ESD types are: 


e Section Definition (SD). Defines the beginning of a named 
control section. 


e Private Code (PC). Defines the beginning of an unnamed 
control section. 


e Label Definition (LD). Defines a label (symbol) whose 


location is defined relative to the location of the control 
section in which it 1s contained. An LD type ESD item 
contains the ESD ID of the control section that contains the 
label. 


e Common (CM). Defines a common area for which a virtual 
storage address is assigned during linkage editor 
processing. The area may be named or unnamed; an unnamed 
area is referred to as a “blank common" area. 


e Pseudo Register (PR). Defines an area external to the 
output module, but referred to by it, for which virtual 
storage space is allocated at execution time. The linkage 
editor treateés PR symbols as a block that is external to the 
program. The value assigned to each symbol 1s a 
displacement within this block. ; 


© External Reference (ER). Specifies a symbol that is 
referenced but not defined within an input module. 


e Weak External Reference (WX). Specifies an external 
reference that is not to be resolved by automatic library 
call. A WX entry is processed as an ER entry with a "weak 
call" flag. 


CESD Record Types and Subtypes 


A load module in the input to the linkage editor contains at 
least one CESD record unless the module is marked not editable 
(NE). The CESD record types are the same as for ESD records, 
with the following additions: 


e Null Type. This indicates that the item is to be ignored in 
any reprocessing of the module by the linkage editor. 


° Label Reference (LR). This defines a label (symbol) within 
a control section. An LR type CESD entry is numbered; it 
contains the ESD ID of the control section entry in the 
ID/length field. An LR may be referenced directly by an RLD 
item in the same module, whereas an LD may not. All LD 
items are changed to LR items during linkage editor 
processing (LDs are contained only in object modules, never 
in load modules). 


° Private Code (PC) Marked Delete. This is a CESD item 
created only for ENTABsS and SEGTABs. PC-delete entries are 


placed in the renumbering table, indicating that associated 
TXT and RLD information is to be deleted. 
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ESD Processing 


The main function of ESD processing is symbol resolution. 
Individual ESDs in the input to the linkage editor are combined 
into a composite ESD, which contains all symbols in the input 
that were not changed, deleted, or replaced. A chained 
replace/change list (produced by the control card scanner) 
specifies which ESD items are to be changed, deleted, or 
replaced. A renumbering table (RNT) is also produced during ESD 
processing; it is used during TXT, RLD, and END processing to 
translate the ESD IDs of the input ESD items to CESD IDs. 
Diagram 9 provides a general illustration of several types of 
ESD processing. 


At the beginning of ESD processing, control information from the 
ESD record is saved: the ESD ID of the first ESD item in the 
record Cother than an LD); the number of bytes of ESD 
information; and the type field of the first ESD item. 


If the OVLY option has been specified for the output load 
module, the following occur: 


e The current segment number is placed in the ESD, unless the 
entry type is PR (PRs have an alignment value in the segment 
number field). 


e The RMODE for the load module is forced to 24. 


e If automatic library call processing is being performed, the 
segment number is forced to 1 (Call automatically called 
modules are placed in the root segment of the overlay 
structure). 


If the OVLY option has not been specified for the output load 
module, 


e If the current ESD item is from a load module in overlay 
format, the AMODE/RMODE data is forced to 24/24. 


° Otherwise, the content of byte 12 is interpreted as 
AMODE/RMODE data. 


The ESD item is then processed according to its type, in the 
following manner: 


e If the ESD item is an ER, bytes 10, 11, and 12 are set to 
zero in the input buffer Ceither the object module buffer, 
the SYSLIN buffer, or the first pass RLD input buffer). 
Byte 10 must be cleared because automatic library call 
processing uses it to indicate whether automatic library 
calls have been processed. Bytes 11 and 12 must be cleared 
because any nonzero data Cincluding blanks) will be entered 
in the delink table if delinking is required for the symbol. 
If the input item is an ER item from an object module, the 
CESD subtype field is also reset to zero to indicate that 
there are no modifiers in the subtype field. 


e If a REPLACE/CHANGE function has been requested for the 
input module, the replace/change chain that was built in the 
CESD by the control statement scanner is examined and the 
appropriate modifications are made. For example, if the 
scanner received the statement CHANGE ACB), the CESD 
contains a line for A, marked as a change statement item in - 
the subtype field; the next line contains the symbol B. The 
input ESD item symbol is changed from A to B during ESD 
processing. 


e If the ESD item is a PC, the CESD is not searched, because 
each PC entry is treated as a unique entry. The PC is 
placed in the next available CESD line and is processed in 
the same manner as an SD. 
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e If the ESD item is a null item, the renumber routine is 
entered. (This routine is described under "Nonresolution 
Processing.™) ; 


e If the ESD item is an LD, it is changed to an LR. The item 
is then processed as an LR. (There are some minor 
differences in processing LDs that have been changed to LRs; 
for this reason, an internal indicator is set when the type 
15 changed to LR.) 


e If the ESD item is a PC or SD, the AMODE/RMODE data is 
checked for a valid combination. If an invalid combination 
1s found, an error message is issued and the RMODE for the 
output load module is forced to 24. 


After the ESD type is determined, the CESD is scanned for a 
matching symbol. If no match is found, nonresolution processing 
is performed. If the input ESD symbol matches a symbol in the 
CESD, resolution processing is performed. Resolution processing 
results in only one CESD entry for each unique input ESD symbol; 
multiple occurrences of the same input ESD symbol are listed in 
aoe renumbering table CRNT) with pointers to the single CESD 
entry. 


NONRESOLUTION PROCESSING: If no matching symbol is found in the 
CESD, the input ESD item is processed as described below. 


SD Items: If the input ESD item is an SD (see Diagram 3, area 


A): 


e The freeline routine selects an empty line in the CESD. The 
line following the current line is chosen unless a previous 
CESD line is marked null. (Whenever possible, null lines 
are used to save space.) 


® If automatic library calls are being processed, an indicator 
is set in the type field of the selected CESD line. (If a 
module map was requested, this indicator is checked during 
module map processing. If the indicator is set, the control 
section is marked with an asterisk in the module map or 
cross-reference table to indicate that 1t was obtained from 
a library during automatic library call processing. ) 


e If the load module is in overlay structure, then those 
routines brought into the load module via the automatic 
library call are placed in the root segment of the load 
module. 


e A "write™ indicator is set in the all-purpose table to note 
that SDs, PCs, or CMs were encountered in the input record. 
When ESD processing is completed, the write indicator is 
tested. If it is on and the TEST attribute was specified, 
ESD records containing SDs, PCs, or CMs are saved, blocked 
3-to-1 in the input RLD buffer and written out on SYSLMOD. 


e In any input object module, the CESD line number of the 
first SD entry whose length is zero is saved. END 
processing uses this CESD line number to enter the length 
specified on the END card. 


e The enter routine creates a CESD entry for the input ESD 
item; it moves the symbol length, segment number, ID, and 
type into the selected CESD line. In addition, the enter 
routine accumulates the residence mode for the output load 
module. Initially, the residence mode is ANY. As each 
control section (SD or PC) is allocated in the output load 
module, its residence mode is included in the accumulation. 
If all control sections allocated in the output load module 
have a residence mode of ANY, the output load module has a 
residence mode of ANY; if any control section allocated in 
the output load module has a residence mode of 24, the 
output load module has a residence mode of 24. (The 
residence mode accumulated from the ESD data may be 
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overridden by the residence mode specifications in the PARM 
field or the MODE control statement. ) 


® The renumber routine places the line number of the new CESD 
entry into the renumbering table to provide a means of 
translating the input IDs to the new CESD IDs. For example, 
if the input ESD item has a line number CESD ID) of 3 but 
the item is placed into the CESD at line 5, a 5 is placed in 
the third line of the renumbering table. (For each input 
ESD line, except LD lines, there is a corresponding RNT 
line. The RNT contains information for the current module; 
it is set to zero at the end of each input module. ) 


ER Items: If the input ESD item is an ER, it is entered in the 
CESD and renumbered as described above; no special processing is 
required. 


WX Items: If the input ESD item is a WX, it is entered in the 
CESD and renumbered as described above; no special processing is 
required. 


CM Items: If the input ESD item is CM (see Diagram 9, area E)> a 
"common" indicator is set and the item is treated as a delete 
item. If the address that was assigned to the CM item by the 
language translator is not zero, it is saved in the delink table 
for later use. (Two CM items with the same identifying symbol 
may have different assigned addresses; therefore, the assigned 
address in the input must be subtracted from all address 
constants that refer to the CM items so that they are returned 
to their displacement value before relocation.) The CM item is 
then renumbered and entered into the CESD. 


LR Cor LD) Items: If the input ESD item is an LR or LD (see 
Diagram 9, area C): 


e When processing an LR, the label routine determines whether 
the SD for the control section has been processed. If the 
SD has not been received, any LRs that refer to that SD are 
chained together in the CESD until the SD is received. (The 
SD might be marked replace; therefore, the LR cannot be 
processed until the SD is received.) When the SD is 
received, all dependent LRs are processed. Each LR ID field 
1s renumbered, using the renumbering table, so that it 
refers to the CESD ID of the SD. 


e LDs are not renumbered, because they are not referred to by 
RLDs and are not numbered in language translator output. 
The enter routine places them directly in the CESD. If an 
LD is received before the SD to which it belongs, it is 
handled as an LR. 


PR Items: If the input ESD item is a pseudo register, the 
current segment number is not entered in column 12 of the ESD 
item. Column 12 of a PR item contains an alignment value, which 
indicates that the PR must be aligned to a halfword, fullword, 
or doubleword boundary. The PR is then processed by the 
freeline, enter, and renumber routines, as described above. 


RESOLUTION PROCESSING: If a matching symbol is found in the 
CESD, the type fields of the input item and the matching CESD 
item are compared and resolution processing is then performed. 
The following conventions are observed during resolution 
processing: 


e Input PR items may match only PR entries in the CESD. If an 
input PR item matches a non-PR item in the CESD, it is not 
treated as a match; the CESD search for a matching PR item 
continues. 


e If the matching CESD item is marked “chained,” resolution is 
performed on the item to which it is chained. 


e If the CESD line is marked null, the match is ignored and 
the search continues. 
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e If the CESD item is an ER produced from a REPLACE, CHANGE, 
OVERLAY, or ALIAS statement, or from the ddname field of an 
INCLUDE or LIBRARY statement, the match 18 tgnored and the 
search continues. 


Matching items are processed in the following manner: 


e If the input ESD item is CM, SD, or LR and it matches an ER 
in the CESD, the input type replaces the type indicated in 
the CESD item (see Diagram 9, area B). Nonresolution 
processing is then performed on the tnput item. 


e If the input ESD item is an LR and it matches a CM, SD, or 
LR in the CESD, a “match” bit is set, indicating that a 
double symbol definition is possible. If the SD for the 
control section has been entered in the CESD and is marked 
for deletion, the Label routine deletes the label; if it is 
not marked for deletion, a "double symbol definition" 
message is produced. If the SD for the control section is 
not in the CESD, the LR is chained to the matching LR; when 
the SD 1s received, the LR is deleted or a double symbol 
definition message is produced, depending on whether or not 
the SD is being deleted. 


e If an input PR matches a PR in the CESD (Diagram 9, area D), 
the greater length and the most "constrictive™ boundary 
alignment are placed tn the CESD entry. (A doubleword 
alignment 1s more constrictive than fullword alignment; 
fullword is more constrictive than halfword; etc.) The 
ee een entry is then renumbered to the updated PR entry in 
the SD. 


e If an input SD item matches an SD entry in the CESD, 
automatic replacement of the control section occurs. The 
input SD item is entered in the CESD as a delete type and is 
chained to the matching SD entry. (During second pass 
processing, the assigned address of the control section 
being replaced will be subtracted ("delinked™) from the 
addresses of any nonbranch-type address constants that refer 
to the SD-delete entry.) The SD-delete item remains chained 
only while the module is being processed; END processing 
will change the chained items to null entries (see 
"Delinking Nonbranch-Type Address Constants”). 


e If an input SD item matches a CM entry in the CESD and the 
length of the SD item is greater than or equal to the length 
of the CM item, the length of the SD item is entered in the 
CESD. If the program is in overlay, the common path routine 
scans the segment path table (SEGTA1) to find the segment in 
the overlay structure that 1s common to both items and 
places the segment number in the SD entry. The SD item is 
then written over the CM line and renumbered. (This is 
referred to as "automatic promotion of common.™) 


° If an input SD or CM item matches an LR in the CESD, a 
"double symbol definition” message is produced and the SD or 
CM item is entered in the CESD as a delete type and is 
chained to the matching LR entry, causing the SD or CM to be 
replaced. 


e If the input item is CM, it may be "blank common.” Blank 
common may match a PC item in the CESD because both contain 
blanks in the symbol field. In such a case, the match is 
ignored and the search continues. 


© If an input CM item matches a CM item in the CESD (Diagram 
9, area F), the greater of the two lengths is entered in the 
CESD. If the module is being processed for overlay, the 
segment number of the segment common to both the input item 
and the CESD item is also entered in the CESD item 
Cautomatic promotion of common). 


e If an input CM item matches an SD item in the CESD, and the 
length of the SD item is greater than or equal to the length 
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of the CM item, the length of the SD item is entered in the 
CESD. The CESD type is not changed. If the module is being 
processed for overlay, the segment number of the segment 
common to both the input item and the CESD item is also 
entered in the CESD item Cautomatic promotion of common). 


Whenever an input ER item matches an ER in the CESD, both 
the type and subtype fields are examined; the ER items are 
then resolved in the following manner: 


= If the subtype fields of both ER items are not marked, 
the input item is not entered in the CESD; the matching 
ER remains in the CESD and a pointer to it is placed in 
the renumbering table entry for the input item. 


- If both items are marked “"*delete,™ the new ER is entered 
in the CESD and the old item remains there so that they 
can be delinked individually Cin this case, the CESD may 
contain two ER items for the same symbol). Delinking is 
described in "Second Pass Processing.”® 


= If the input ER item is marked for deletion, but the ER 
item in the CESD is not marked delete, the input ER is 
chained to the matching ER in the CESD. The chained ER 
item remains in the CESD until end-of-module is detected 
so that the delink value can be saved. 


= If the input ER item is not marked for deletion and the 
ER item in the CESD is marked "delete"™ or "replace," the 
delete bit in the subtype field is cleared (delete is 
changed to replace) and the item is renumbered. If the 
matching ER item in the CESD is marked "no call” or 
"library member,™ it 1s marked "matched" before 
renumbering. 


= If the input ER item is marked in the subtype field, but 
is not marked "delete" or "replace," it is assumed to be 
"never call"; if the matching ER item in the CESD is 
"library member,™ the CESD item is removed from the 
chain of library members and the input ER item is 
entered in the CESD and renumbered. 


If an input WX matches a WX in the CESD, no change is made 
to the CESD. If the matching entry in the CESD is not a WX 
or a control card entry, the input WX is changed to an ER. 


If an input ESD item that is not a WX matches a WX in the 
CESD, the CESD item is changed to an ER. In all cases, 
processing continues normally. 


The manner in which CSECT identification records CIDR) are 
processed depends on the type of IDR input records or control 
statements being processed. The input records or control 
statements are: 


Object module END records 
Load module IDRs 
IDENTIFY control statements 


An object module END record contains only translation data; 
onc: load module IDRs may contain four different types of 
D ata: 


HMASPZAP-Supplied data 
Linkage editor data 


Translator-supplied data 


Method of Operation 39 


This document contains restricted materials of IBM. © Copyright IBM Corp. 1972,1983 
LY26-3921-0 


° User-supplied data 


Load module IDR processing is dependent upon the type of data 
present in the IDR record. The IDENTIFY control statement 
contains only user-supplied data. 


Before any IDR data processing begins, the type of IDR input is 
determined either by the input processor HEWLFINP or, if the 
data is from the IDENTIFY control statement, by the control 
statement processor HEWLFSCN. HEWLFINP passes control to 
HEWLFIDR at the entry point HEWLFIDR. HEWLFSCN passes control 
to HEWLFIDR at the entry point HEWLCIDR. 


Processing Object Module END Records Containing IDR Data 


When byte 33 of an object module END record has an EBCDIC 1 in 
it, one IDR item follows in bytes 34 through 52. If an EBCDIC 2 
appears in byte 33, two IDR items follow in bytes 34 through 71. 
A blank in byte 33 indicates that the record contains no IDR 
data. IDR data is present only on an object module END record 
if a Bali ahs that produced the object module contains IDR 
support. 


The renumbering table is scanned to determine the correct ESD 
identifiers of the CSECTs to which the translator data applies. 
If any of the CSECTs are marked delete in the renumbering table, 
they are not identified in the IDR output. If the input object 
module contains at least one CSECT that is not marked delete, 
the translator data is removed from the END record and placed in 
the IDR translator data table CIDRTRTAB) and the IDR translator 
ID table CIDRTITAB). These two tables contain the ESD 
identifier of the CSECT to which the translator data applies, 
the translator identification, the version and modification 
level of the translator, and the date of translation. 


A comparison is made with the other entries in the IDRTIRTAB for 
a duplicate entry. If a duplicate entry is found, the incoming 
data 1s combined with that of the previous entry to avoid 
repetition of data. 


Processing Load Module IDRs 


The subtype of the load module IDR is scanned for the type of 
IDR data. If the subtype is 02, the data is from the linkage 
editor; these records are ignored by IDR input processing. When 
the input data is from HMASPZAP Csubtype 01), bits 2 through 7 
of the flags and count field are scanned to determine the number 
of HMASPZAP entries in the record (from 1 to 19 entries are 
possible). 


The entry in the renumbering table corresponding to the ESD 
identifier of the CSECT processed by HMASPZAP is examined. If 
the entry in the renumbering table is marked delete, then the 
IDR data associated with that CSECT is deleted. However, the 
data that is not deleted is placed at the end of the IDR 
HMASPZAP data table CIDRZPTAB). IDRZPTAB contains the ESD 
identifier of the CSECT processed by HMASPZAP, the date of the 
HMASPZAP processing, the data specified during HMASPZAP 
processing (this may be a PTF number or up to 8 bytes of 
variable user data specified on an HMASPZAP control statement). 
If the IDRZPTAB overflows, an error message is written and 
processing is terminated. 


When the input data is translator-sSupplied data (subtype 04), 
the renumbering table entry corresponding to each ESD identifier 
in the string preceding a translator description is examined. 

If the entry is marked delete, the corresponding ESD identifier 
is deleted from the string; otherwise, the input ESD identifier 
is replaced by the renumbered identifier. If at least one ESD 
identifier remains on the string, a check is made among the 
table entries in the IDR translator data table CIDRTRTAB) to see 
whether an identical description has already been entered into 
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TXT Processing 


IDRTRTAB. If an identical description does exist in IDRTRTAB, 
the CSECTs associated with the incoming translator description 
are combined with the existing translator data item to form a 
single table entry in order to avoid needless repetition of 
a If it does not exist, a new entry is added for the input 
ata. 


When the input data is user data (subtype 08), the renumbering 
table entry corresponding to the ESD identifier of each input 
user data item is examined. If it is marked delete, the user 
data is ignored. If not, the input ESD identifier is replaced 
by the renumbered identifier and the user data is entered at the 
end of the IDR user data table CIDRUDTAB). The IDRUDTAB entries 
contain the ESD identifier of the CSECT to which the user data 
applies, the date the data was supplied to the module via the 
linkage editor IDENTIFY function, the number of characters in 
the user data field, and the user data. 


In the case of input load module IDRs containing translator or 
user-supplied data, an individual data item may span more than 
one record. When this occurs, the incomplete portion of the 
item is saved in either IDRTRTAB or IDRUDTAB. The item is 
processed after the next input record has been read, and the 
continued portion of the item is combined with the saved portion 
to form a complete data item. 


Control Statement Data 


The control statement processor, HEWLFSCN, passes control to the 
IDR processor at the entry point, HEWLCIDR. The CESD is 
searched for an SD type entry matching the CSECT name to be 
identified. If the name is not an SD, an error is logged and 
processing is terminated. If the CESD line is an SD marked 
delete, the data is ignored. If the CESD line is an SD not 
marked delete, the ESD identifier of the matched SD name is 
saved. A check is made to see whether there was any 
user-supplied data previously associated with the CSECT. If 
there was, the old data 1s replaced with the new incoming data. 
If no earlier data exists, the incoming data is added to the end 
of the table IDRUDTAB. 


The manner in which TXT records are processed depends on whether 
they are part of a load module or an object module or are added 
using the EXPAND control statement. A load module contains 
records in a specified order. However, in an object module, the 
records may not be in the proper sequence because the language 
translator may have created them out of order CEXPAND data is 
always identified as out of order text). (The restrictions on 
linkage editor input are described in "Appendix. Input 
Conventions and Record Formats.") Diagrams 10 and 11 illustrate 
processing of TXT records from object and load modules, 
respectively. 


Before any address constants can be relocated within a control 
section of an object module, all TXT records must be placed in 
the proper order. This is done in the input text buffer 
CTXTBFBEG), which is variable in length, allowing grouping of 
data within the buffer. 


Each “multiplicity” of text is assigned a number as it is moved 
Cor read) into TXTBFBEG. A multiplicity is a portion of text 
equal in length to the maximum size of a SYSLMOD output record. 
Within each control section, multiplicity numbers are assigned 
consecutively, starting at 0 


Text records from object modules contain both text data and the 
control information needed for processing. Text records from 
load modules contain only text, so the associated control record 
must also be examined to obtain the required control 
information. During object module processing, control 
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information is placed in registers; this information allows the 
object module text to be moved from the object module buffer 
into TXTBFBEG. For load module text, the assigned address of 
the first byte of text and a pointer to the ID-length list Cin 

the control record) is determined during load module processing. ) 
a cas allows the text record to be read directly into 

T BEG. 


Processing Object Module Text 


When text is received from an object module, the text record ID 
1s renumbered, using the renumbering table, so that it refers to 
the CESD entry for the control section that contains the text. 
The size of the control section is obtained from the CESD, and a 
test is made to determine if the whole control section or a 
multiplicity (whichever is smaller) will fit into the space 
available in TXTBFBEG. If the control section length was not 
specified in the CESD entry, only text for the current ID is 
accepted; see "No-length Control Section,” below. 


If there is sufficient space in TXTBFBEG to accommodate the 
tabletext I/0 table control section or multiplicity, the text is 
moved into the buffer, and an entry (containing the ID and 
multiplicity number of the text) is made in the text I/0 table. 
A corresponding entry, containing the location of the 
multiplicity and the length of the text, is made in the text 
note list. The text note list entry also contains a 
displacement field. When text is in order, or on the first 
occurrence of text for a multiplicity, the displacement field is 
set to 0; for out-of-order text the displacement field contains 
the displacement from the beginning of the multiplicity of the 
first byte of contiguous text 


If the SYSUT1 record size is smaller than the multiplicity size, 
each multiplicity is divided into pieces, each piece having a 
length equal to the SYSUT1 record size. New text I/0 table and 
text note list entries are made for each piece; the displacement : 
field will contain the displacement of each piece from the ] 
beginning of the multiplicity. 


NO-LENGTH CONTROL SECTION: When text is received for a no- length 
control section (a control section for which no length is 
specified in its CESD item), space for one multiplicity is 
allocated in TXTBFBEG. Entries are made in the text I/0 table 
and the text note list for the multiplicity, and the text is 
moved into TXTBFBEG. This procedure is repeated for each 
subsequent multiplicity of text for the no-length control 
section. If TXTBFBEG becomes full, its contents are written on 
SYSUT1 as described in "Writing Text on SYSUT1." When the length 
is received, it is entered in the text note list. 


PROCESSING OUT-OF-ORDER TEXT: A load module contains records in 
a definite order. However, records in an object module may not 
be in the proper sequence because the language translator may 
have created them out of order (records resulting from the 
EXPAND control statement are marked out of order). Such records 
may contain discontinuities in addresses (because of a reorigin 
or a disjointed control section), or they may not be contiguous 
(that is, text of a given ID and multiplicity may be 
interspersed with text of other IDs or multiplicities). Records 
of contiguous text must be built on SYSUT1 so that during second 
pass processing, the text can be placed into its proper 
position, within its ID and multiplicity, in the second pass 
text buffer. 


The first occurrence of a given ID and multiplicity is read into 
the input text buffer as it is received. Discontinuities and 

noncontiguous text are of no consequence at the first occurrence 
of an ID and multiplicity. However, once text of a given ID and 
multiplicity has been written out on SYSUT1, any subsequent text 
of that ID and multiplicity must be contiguous to be written out 
on SYSUT1 within each text record. 
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Text of a previously written ID and multiplicity is read into 
the input text buffer until a discontinuity, or text of a 
different ID or multiplicity, is encountered. The contiguous 
text in the buffer is then written out on SYSUT1. The 
discontinuous Cor noncontiguous) text is then placed in the 
buffer. If this text represents the first occurrence of an ID 
and multiplicity, the buffer is loaded without regard for 
discontinuities or noncontiguous text. If the text belongs to a 
previously written ID and multiplicity, the text processor will 
again place only continuous text of that ID and multiplicity in 
the buffer. 


A record that contains noncontiguous text is called a loose 
record; a record that contains contiguous text is called dense. 
The text note list entry for a dense record usually has a 
nonzero value in the displacement field. When the text is read 
back from SYSUTI1 into the second pass text buffer, during second 
pass processing, this displacement is used to place the text in 
its proper position within its ID and multiplicity. 





Processing Load Module Text 


Because text records from load modules are ordered and 
well-defined, they require little further processing by the text 
processor. The information in the ID-length list Cin the 
control record) is scanned, and each ID is renumbered and 
checked to determine whether it is to be deleted. If all IDs 
are to be deleted, the record is ignored, and control is 
returned to the input processor. 


When an ID that is to be processed is found, the text record 
containing the ID must be read into TXTBFBEG. The text record 
length is obtained from the associated control record and 
compared against the free space available in TXTBFBEG. If 
sufficient space is available, the text record is read into the 
buffer; otherwise, the contents of the buffer are written on 
SYSUT1 to ensure sufficient space, and the record is read. 


Text is processed in the buffer in the order specified by the 
ID-length list. IDs that are to be deleted are overlaid by IDs 
that are to be processed. The text is divided into 
multiplicities, and entries are made in the text I/0 table and 
the text note list. When all text identified by the ID-length 
list is processed, text processing is completed. 


Writing Text on SYSUTL 


When no more control sections can be accommodated in TXTBFBEG, 
the contents of the buffer must be written on the intermediate 
data set (SYSUT1). The text I/O table is scanned to determine 
the order in which control sections are to be written. The 
length of the first control section (that is, corresponding to 
the first text I/0 table entry) is obtained from its 
corresponding ESD ID; if the length is less than the size cof the 
SYSUT1 record, the text I/0 table entry for the control section 
is marked "written." Each subsequent control section is 
similarly processed, and its length added to the sum of the 
lengths of previously processed control sections. 


When the sum of control section lengths reached the limit of a 
SYSUT1 record, the entire group of control sections is written 
on SYSUT1. The relative track address (TTR) is placed in the 
text note list entry corresponding to the last text I/0 table 
entry that was processed. 


When a single control section is larger than a SYSUT1 record, 
the multiplicities of the control section are grouped, up to the 
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limit of the SYSUT1 record size, and written.® When control 
sections or multiplicities are grouped on SYSUT1L, the 
multiplicities must be in ascending, consecutive order. If the 
overlay attribute has been specified, no grouped control 
sections are permitted on SYSUT1. 


NOTE: Each time an entry is made in the text note list during 
text processing, a check is made to determine whether the list 
is full. If it is full, the contents of TXTBFBEG are grouped 
Cif possible) and written on SYSUT1, and the TTRs are placed in 
the text note list. The list is then written on SYSUTL, and its 
address is noted in the J]/0 control table. The text note list 
may be written a maximum of 11 times. 


If neither TXTBFBEG nor the text note list becomes full during 
text processing, no text is written on SYSUT1. The text is 
retained in the buffer, and single pass processing is in effect 
for text records. 


RLD processing basically consists of: 


° Updating each set of relocation and position pointers (R and 
P Pointers) 


e Processing each flag and address (FA) itn the input item 
until the end of the record or the next item with an R and P 
pointer is detected 


RLD records from object modules and load modules are processed 
in the same manner. 


RLD information is grouped in the RLD buffer by P pointer. Each 
P pointer of an input RLD record refers to the ESD entry in the 
input module for the control section that contains the address 
constant. Each time a new P pointer Cone referring to a 
different ESD ID) is detected, an entry is made in the RLD note 
list for the RLD set (a set being an unbroken sequence of RLD 
items having the same P pointer). The RLD note list entry 
contains the following information for each set: 


e The renumbered P pointer to which these RLDs refer. 
° The lowest multiplicity of text to which these RLDs refer. 
e The number of bytes of RLDs. 


e The storage address of the first byte of RLD data if all 
RLDs remain in virtual storage. If RLDs are written on 
SYSUT1, this field contains the accumulated byte count for 
intermediate chains or the TTR of the record on SYSUTI1. 


All adjacent RLD items containing the same P pointer are 
referred to by only one RLD note list entry. Adjacent RLD items 
containing the same R and P pointers are chained, with the R and 
P pointers appearing only once, at the beginning of the chain. 
The remaining RLDs in the chain are compressed by setting the 
flag indicating continuation and discarding the four bytes 
containing the R and P pointers. 


Each R pointer of an input RLD record refers to the ESD entry in 
the input module upon whose value the address constant depends. 
The R and P pointers are updated, using the renumbering table. 
Before renumbering, the R and P pointers refer to ESD entries of 
the input module that contains the RLD items. The pointers are 
renumbered so that they point to the proper entries in the CESD 
being created for the output load module. If the R pointer 
refers to a deleted ESD entry, delinking may be performed. If 


. If the SYSUTI record size is smaller than the SYSLMOD record J 


size, no grouping is permitted. 
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the assigned address of the symbol referred to by the address 
constant is zero, the address constant is not delinked. (Normal 
relocation is performed.) When delinking is necessary, an entry 
is placed in the delink table (a function of ESD processing). 
The delink table entry contains the address (delink value) of 
the symbol being deleted and the CESD entry number of the 
identically named symbol that is to replace the deleted symbol. 


The ID of the delink table entry for the deleted symbol is saved 
in the renumbering table, and a "delink value saved" indicator 
is set. The ID of the identically named symbol and the ID of 
the new delink table entry are saved because they are later used 
to complete the delinking operation. The R pointer of the RLD 
item must be modified to refer to the delink table entry for the 
deleted symbol, but the original R pointer is needed to process 
any V-type address constants referred to in the RDL item. 
(V-type address constants do not require delinking, but may be 
in a FA string with A-type address constants that do require 
delinking.) Therefore, the R pointer is not modified until the 
string of flag-address (FA) fields following the R and P 
pointers has been processed as described below. At that time, 
if the module is to be structured for overlay and it contains 
V-type address constants that refer to the deleted symbol, the 
ID a the identically named symbol is inserted into the calls 
list. 


Each FA field of the RLD record is processed as follows: 
e The high-order bit of the flag field is set to zero. 


e If the address constant is an A-type, the renumbering table 
entry referred to by the R pointer is checked to determine 
whether it is marked as a PR type. If it is a PR, the RLD 
flag field is also marked PR (because second pass processing 
must handle PRs in a special manner). If the renumbering 
table entry is not an ER or marked delete, the RLD flag 
field is marked for relative relocation. This indicates to 
second pass processing that the difference between the 
origin of the control section in the input and the origin 
assigned by the linkage editor is to be used as a relocation 
factor for the value of the address constant. If the RNT 
entry 1s an ER or marked delete, the RLD flag field is not 
marked. This indicates to second pass processing that the 
address constant is to be relocated by absolute relocation; 
second pass processing uses the linkage editor assigned 
address of the symbol in the output module as a relocation 
factor for the value of the address constant. (This 
procedure is described in “Second Pass Processing.™) 


e If the address constant is a &-byte V-type ("branch-type™) 
and the program is in overlay, an entry is placed in the 
calls list, provided that the address constant refers across 
control sections (R not equal to P). The calls list is used 
during address assignment processing to determine which 
segments require ENTABs and the number of entries each ENTAB 
must contain. 


e For both A-type and V-type address constants, the text 
multiplicity of the address field is determined and is saved 
in the RLD note list if it 1s lower than any previous 
multiplicity in the RLD record. If two pass processing is 
in effect, the RLD note list is used during second pass 
processing to read back RLD data from SYSUTI1 Ceach RLD note 
list entry contains the relative track location (TTR) of an 
RLD record on SYSUT1). The second pass processor uses the 
multiplicity field of the RLD note list entry to determine 
whether the associated RLD record should be read back from 
SYSUT1 for a given multiplicity of text. 


° When the last FA field in the string has been processed, all 
items in the string have been checked to determine whether 
they require delinking. If any A-type address constants in 
the string required delinking, the R pointer for the string 
is modified to refer to the associated delink table entry. 
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Figure 16 shows the actions performed during RLD processing for 

each input flag format, and the format of the flags after RLD 
processing. (The “output” column shows the flag formats that 

are passed as input to the Relocation routine of second pass 
processing; see Figure 27 on page 69.) After all FA fields have 2 
been processed, the next RLD record processed. 


If the RLD buffer becomes full, its contents must be written on 
the intermediate data set (SYSUT1). The RLD buffer is allocated 
with a maximum length less than or equal to the size of a SYSUT1 
record, so the entire buffer may always be written. As many 
consecutive RLD sets as possible are grouped in a SYSUT1I record. 


Output 
Action Performed Type 


OO00LIST Not PR, Marked for relative relocation LOOOLIST Relative 
ER, WX, 
CM, or 
delete 


OOOOLIST ER (02° Marked for absolute relocation OOO0OLIST Absolute 
in renum- 
bering 
table) 


OOOOLIST Delete or Marked for absolute relocation OOOOLIST Absolute 
CM €'05') if assigned address of input 
item is zero 


OOOOLIST PRC'06') Marked as PR (displacement OO1LOLIST Pseudo 
value) Register 
Type 1 


OOOOLIST Delete or Marked "delink value saved" if High-order Delink 
CM assigned address of input item bit of P 
is not zero pointer yy 


OOO1LIST Type is RLD is marked branch-type OOO1LLIST Branch 
not 
checked 


OOOLILIST Delete Marked "delink value saved and High-order 
or other FA items in string exist bit of P 
1001LIST# that are nonbranch-type™ and pointer. 
are being delinked 


OOLOLIST Pseudo None. Remains as a PR OO1LOLIST Pseudo 
Register (displacement value) Register 
Type 1 Type 1 


OO1LILIST Type is Marked as PR (cumulative OOLLLIST Pseudo 
not length) Register 
checked Type 2 





Figure 16. RLD Flag Field Processing 


Notes to Figure 16: 

1 Refer to "RLD Input Record (Card Image)" and "Relocation 
Dictionary Record (Load Module)” in “Appendix. Input 
Conventions and Record Formats." 


2 Internal types processed during second pass. 
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END Processing 


Include Processing 


The RLD note list entry for each RLD set in the group contains a 
"grouped" indicator; the note list entry for the last RLD set in 
the group also contains the relative track address (TTR) of the 
group. 


RLD sets whose lengths exceed that of a SYSUT1 record (requiring 
more than one output record) are not grouped. RLD note list 
entries for RLD sets that are not grouped contain the relative 
roace location (TTR) of the SYSUT1 record and a "nongrouped"” 
indicator. 


Each time an entry is made in the RLD note list, a check is made 
to determine whether the list is full. If it is full, the RLD 
sets in the RLD buffer are grouped and written on SYSUT1, and 
the TTR is placed in the appropriate RLD note list entry. The 
RLD note list is then written on SYSUT1 and its address is noted 
in the "I/0 control table.” The RLD note list may be written a 
maximum of three times. 


Note: If neither the RLD buffer nor the RLD note list becomes 
full during RLD processing, no RLDs are written on SYSUT1. The 
RLD information is retained in the RLD buffer, and si e 
processing is in effect for RLDs. 


When an END record or the end of an input load module is 
detected, END processing is required. The functions of END 
processing include: 


e Resetting tables (such as the renumbering table) that were 
involved in the processing of the input module 


S Processing entry point information 


° Deleting any CESD lines marked CHAIN or DELETE, and keeping 
track of deleted lines 


e Entering in the CESD the length of a control section for 
which no length was specified in the ESD item Cif the length 
is contained on the END record) 


° Setting flags in the ORDER table for each entry matched by 
an entry in the CESD and resetting the flag for formerly 
matched entries 


° Placing the data from END records in object modules created 
by a translator that supports IDR into the IDR translator ID 
and data tables, IDRTRTAB, and IDRTITAB 


® 


Include processing is required when: 

e The control statement scanner has detected an INCLUDE 
statement and the INCLUDE statement processor has built an 
include chain. 


e End-of-input has been detected, and the "more includes” 
indicator in the all-purpose table (CAPT) is on. 


Include processing consists of preparatory functions (OPEN, 
BLDL, FIND) required before the module to be included can be 
read. These functions include: 


e An input pointer to the library read block is set. 


e The SYSLIB DCB is closed Cunless it is open for a 
partitioned data set currently being used). 


e Each entry in the include chain is examined sequentially. 
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SEQUENTIAL DATA SETS: If an include chain entry specifies a 
sequential dat set, the data set organization field of the DCB 
is changed from partitioned to physical sequential, and the 
pcpoue te is updated. The DCB is then opened, and the module 
is read in. 


PARTITIONED DATA SETS: If an include chain entry specifies a 
member of a partitioned data set, the member name is entered 
into the BLDL list, and the next entry is examined. If the next 
entry specifies a different data set name, the partitioned data 
set 15 opened and a BLDL macro instruction is executed for the 
single member name. 


If the next entry specifies another member of the same 
partitioned data set, the member name is added to the BLDL list 
and the next entry in the include chain is examined. Member 
names are added to the BLDL list until a different data set name 
is encountered, the BLDL list becomes full, or the end of the 
include chain is reached. Because the BLDL list must be in 
collating sequence, each member name is inserted into its proper 
position, moving other entries as necessary. Because included 
modules must be read in the order in which they appear in the 
INCLUDE statement Cwithout regard to the collating sequence), a 
separate table, indicating the order of processing BLDL list 
entries, 15 maintained. 


When the BLDL list is completed, the partitioned data set is 
opened and the record format field (RECFM) in the DCB is tested 
to determine whether the included modules are load modules 
Cundefined format) or object modules (fixed format). If they 
are load modules, the "load module" indicator is set in the APT. 
This indicator is tested when each module is read in. A BLDL 
macro instruction is then executed for the member names in the 
list. The list is then examined in the order specified in the 
INCLUDE statement to obtain the attributes of each included 
module Cif it is a load module); the attributes of the output 
load module may be "downgraded"™ accordingly in the APT. 


If the BLDL macro instruction was successful for a particular 
member, the member is read in. The FIND macro instruction and 
the directory entry obtained from BLDL are used to set a pointer 
in the DCB to the first record of the member. If the BLDL was 
not er a for a particular member, a diagnostic message is 
printed. 


The INCLUDE processor checks the PDS directory information 
returned by BLDL for an included load module to determine 
whether the load module is in overlay format. If it is, an 
indicator is set in the all-purpose table so that the ESD 
processor can interpret byte 12 of each ESD item as a segment 
number rather than as AMODE/RMODE data. 


An example of INCLUDE processing is given in Figure 17 on page 
49. The input pointer is set to the address of the library read 
peooa The address of the current include item is contained in 
he APT. 


Assuming that no includes have yet been processed. A will be 
the first item examined. The subtype "DO" indicates that A is a 
member of a partitioned data set, so A will be entered into the 
BLDL list. The pointer 000D refers to the data set DATASETX. 
The next item in the include chain, B, is also a member of 
DATASETX, so it is added to the BLDL list. The next item in the 
chain, M, 15 a sequential data set (subtype C0), so the BLDL 
list is completed with two entries (A and B). Assuming that 
DATASETX is not currently open and the SYSLIB DCB is not opened 
for another data set, the SYSLIB DCB is opened for DATASETX. 
(The RECFM field of the data set DSCB is merged into the DCB.) 
Assuming that the RECFM field indicates undefined (U) format, a 
load module indicator is set in the APT, and a pointer to the 
load module buffer is placed in the library read block. The 
attributes of A and B are obtained, using the BLDL macro 
instruction, and the attributes previously specified are updated 
accordingly. (The attributes of the output load module may be 
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downgraded as a result.) A pointer in the DCB is then set to 
the first record of member A, using the FIND macro instruction, 
and the "include initiated” indicator is set in the APT. 
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Figure 17. Include Processing 


Member A is read using the input pointer and library read block. 
Module A is then processed. When the end of module A is 
reached, item A is deleted from the chain and the CESD line is 
marked null. Member B is then read and processed. 


When the end of module B is reached, item B is deleted from the 


chain, the CESD line is marked null, and the remainder of the 
chain is processed. 
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Automatic Library Call Processing 


& 


Automatic library call processing is required: 


e At the end of SYSLIN input when unresolved ERs still exist, } 
and the NCAL option was not specified 


e When a NAME statement has been detected (provided that the 
NCAL option was not specified and no more entries in the 
include chain are to be processed) 


Automatic library call processing consists of two series of CESD 
scans. The first series of scans operates on unresolved ERs 
specified on LIBRARY statements. It finds the first ddname that 
contains a pointer in the chain pointer field (bytes 14 and 15). 
Such an entry is the first item in a chain of members associated 
with this ddname; there is a distinct chain for each ddname that 
was specified on a LIBRARY statement. Chained member names for 
a particular ddname are entered into a BLDL list, which is 
processed as previously described under "INCLUDE Processing.” 


The scan of the CESD continues until all ddname chains have been 
processed. A second scan of the CESD then searches for ERs not 
specified on LIBRARY statements and attempts to resolve them by 
calling members of the same name from SYSLIB. 


An example of automatic library call processing is given in 
Figure 18 on page 51 . Diagram A shows two library chains that 
were built in the CESD by the library statement processor. In 
Figure 17 on page 49, Diagram B, an SD item for JOE has been 
entered in the CESD, resolving the reference to JOE. (JOE was 
removed from the chain by ESD processing, and the LIB1 chain ID 
now points to the line containing TOM.) Automatic library cali 
processing operates on the library chains, as modified by ESD 
processing (Diagram B). 


In the first series of scans, the CESD is searched for a ddname 
(type 02, subtype BO) with a chain pointer. The ddname item 
LIB1 is found; its chain ID points to TOM. Because TOM is ) 
unmatched (subtype 02), it is not called and because TOM is the 
last item in the chain (0 in the chain ID field), the scan is 
resumed for another ddname with a chain pointer. LIB2 is found; 

its chain ID points to SAM. No call is issued for SAM, because 

it is unmatched. The chain ID of SAM points to PETE, which is 
matched (Cindicating that PETE is an external reference, and not 
just an operand of a LIBRARY statement). PETE is entered in the 
BLDL list; because PETE is the last item in the chain, the list 

is completed with one entry. 


LIB2 is opened and the BLDL macro instruction ts used to obtain 
the attributes of PETE (the attributes of PETE are not obtained 
if the format is fixed (F)). A "BLDL attempted” indicator is 
set for the CESD entry for PETE so that no other search for PETE 
will be made in the event of an unsuccessful BLDL or 
nonresolution of the ER for PETE by the member PETE. The FIND 
macro instruction is used to set a pointer in the SYSLIB DCB to 
the member PETE. PETE is then read in. 


When processing for PETE is completed, the scan for ddnames 
resumes at the beginning of the CESD, rather than at the CESD 
line where the scan was interrupted, because additional ddname 
items may have been entered at any available line in the CESD. 
(Object modules with additional LIBRARY statements may have been 
read in.) When the last line of the CESD is reached, the second 
series of scans is begun. 


eee weed 


a SYSLIB is the standard library whenever the linkage editor . 
is executed as a job step. If another program links to the 
linkage editor, the ddname of the standard library is passed 
in a parameter list. 
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Figure 18. Automatic Library Call Processing 


During the second series of scans, the CEDS is searched for 
"unmarked™ external references (type 02, subtype 00). These are 
ER items not specified on LIBRARY statements. In Diagram B, the 
scan finds SIMPLE. Assuming that SYSLIB is the ddname for the 
standard library, SIMPLE is called from SYSLIB in the same way 
that PETE was called from LIB2. Every time automatic library 
call processing is resumed after a module is read, the second 
series of scans resumes at the beginning of the CESD (because ER 
items from a library member may have been entered in any 
available CESD line). 


When the second series of scans is finished, input processing is 
complete. 


INTERMEDIATE PROCESSING 


The intermediate processing comprises modules HEWLFADA, 
HEWLFOUT, HEWLFENS, HEWLFENT, and Coptionaliy) HEWLFMAP. 


When all input processing is completed, the second phase of the 
linkage editor Cintermediate processing) begins operation. The 
two major functions of the second phase are address assignment 
and intermediate output. 
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At the conclusion of input processing, address assignment 
processing is required (see Diagram 13). Address assignment 
includes the following operations: 


0 @ 


Delete CESD entries for ER items marked included, called, 
ddname, or overlay in the subtype field. These lines are 
marked null and are deleted if the module is processed again 
in a subsequent execution of the linkage editor. 


Compute, for programs in overlay, the size of SEGTAB,® enter 
the size in the all-purpose table, and place a private code 
delete entry for the SEGTAB in the CESD. The PC-delete 
entry is deleted from the module if it is processed again by 
the linkage editor (see Diagram 13, area A). 


Determines whether the first text record of a load module is 
not assigned to address 0. If it is not assigned to address 
0, a private code delete entry of one byte is created in the 
CESD. The PC-delete entry is deleted from the module if the 
module is later reprocessed by the linkage editor. 


Enter segment numbers for label references in the CESD. If 
the program is in an overlay structure, the calls list 
(built during RLD processing) is also scanned, and pointers 
from one chain of calls to the next chain are entered (area 
B); the number of ENTAB bytes® for each segment is 
determined; and a PC-delete entry is placed in the CESD for 
each ENTAB (see "ENTAB Size Determination"). 


Assign temporary linked addresses to SD, PC, and CM entries 
in the CESD (area C). SDs and CMs that have entries in the 
ORDER table are addressed first in the order of their 
appearance in the table. The remaining control sections are 
then assigned addresses to the SDs, PCs, and CMs that have 
no entries either in the ORDER table or the text I/0 table. 
To avoid assigning addresses to any SD or CM more than once, 
a "processed" bit (bit 4 of the ‘type’ byte in the CESD) is 
set in each CESD entry when it is first processed. The bit 
is reset to zero in the final scan of the CESD. 


Consider each segment to be at zero origin. The temporary 
starting address of each control section is computed with 
consideration for its location in the segment, relative to 
the zero origin (plus any adjustments for boundary 
alignment). These addresses are temporary because the 
starting addresses of the segments must later be relocated 
with respect to their positions in the overlay tree. If the 
program is not in overlay (consists of a single segment), 
the addresses are final, because no further relocation by 
address assignment 18 necessary. 


Perform page alignment while assigning temporary linked 
addresses if the program is not in overlay. The ORDER table 
is searched for a match of the CESD ID of the SD or CM being 
processed. When a match is found, and page alignment is 
specified, the assigned address is forced to a 4K-byte 
boundary. If the ALIGN2 option is taken, the address is 
forced to a 2K-byte boundary. 


Compute the temporary relocation constant for each control 
section (the difference between the temporary linked address 
and the assigned address in the relocation constant table 
(RCT) Carea D). If the program is not in overlay, these are 
the final relocation constants (relative relocation 
factors). 


SEGTAB size = 24 + (4 x number of segments). 
ENTAB size = 12 + (€12 x number of unique downward calls per 
segment). 
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Accumulate the length of each segment in the leftmost 3 
bytes of an entry in the segment length table (SEGLGTH). 
The boundary alignment factor of the first control section 
in the segment is placed in the fourth byte of the entry. 


Determine the address of each PR entry in the CESD, using 
the total length of all PRs previously encountered, plus the 
boundary alignment factor. This address is placed in the 
CESD entry for the PR. The length of this PR is then added 
to the cumulative PR length. 


Process the SEGLGTH table (Cif the program is in overlay) to 
determine the starting address of each segment, relative to 
the beginning of the program (area E). SEGTA1 is checked to 
find the proper location of each segment in the tree. 
SEGLGTH at this time contains the length of each segment. 

To determine the starting address of a segment, the length 
of all previous segments in the same path are added, 
together with any adjustments for boundary alignment. 
CBoundary alignment adjustment is determined by the last 3 
bits of the address of the first control section ina 
segment.) This sum, minus the boundary alignment factor for 
the segment, is the segment relocation constant (SRC). The 
SRC is then placed in the rightmost 3 bytes of the SEGLGTH 
table. The sum of the SRC, the boundary alignment factor, 
and the segment length is placed in the leftmost 3 bytes of 
the SEGLGTH table entry for the segment. It is the length 
of the path of the segment Cincluding the segment itself). 
At the completion of this process, the entry in SEGLGTH for 
each segment contains the cumulative length of its path; the 
longest of these lengths is the program length. 


Perform a second scan of the CESD if the program is in an 
overlay structure. The segment relocation constant in the 
SEGLGTH table is added to the temporary linked address in 
the CESD entry for the control section; this sum is the 


final linked address. The SRC is also added to the 


temporary relocation constant table; this sum is the final 


relocation constant for the control section. 


Assign final linked addresses in ascending order of segments 
if page alignment is specified for any SD or CM type symbol. 
For each segment, three cycles of scanning are performed. 
First, SDs and CMs having entries in the ORDER table are 
processed. The final address is calculated by adding the 
SRC and the temporary linked address, and is aligned ona 
page boundary, if required. A cumulative count of any 
Increment within a segment caused by page alignment is kept, 
in order to assign correct addresses to the unprocessed SDs, 
PCs, and CMs. Next, the text I/0 table is scanned for the 
remaining SDs and PCs in the segment. These SDs and PCs are 
assigned final addresses. Finally, a scan of the CESD gives 
addresses to all unprocessed SDs, PCs, and CMs in the 
segment. For every processed SD, its entry in the 
relocation constant table is calculated. Before going on to 
the next segment, the length of the segment just processed 
and the SRC of the next segment are updated. 


Make a final scan of the CESD to assign a final linked 
address to each label reference. 


The CESD entry for each LR contains a reference to the 
control section in which it resides. The relocation 
constant for that control section is located in the RCT and 
is added to the temporary linked address in the CESD entry 
for the LR. This sum, the final linked address for the LR, 
is placed in the CESD. 


Mark the program as not executable if there are still 
unresolved ERs and if neither the NCAL option nor the LET 
option has been specified. Unresolved WXs do not inhibit 
program execution. 
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e Build the alias table and compute an entry point for the 
program (see "Entry Processing™). 


ENTAB Size Determination J 


ENTAB size determination consists of computing the size of 
ENTABsS so that the size of each segment in an overlay program 
can be determined and relative relocation factors can be 
computed for use by second pass processing. The size is 
determined by the number of downward calls, or calls across 
regions, to symbols that are not referred to by segments higher 
in the path of the calling segments. 


An example of ENTAB size determination is given in Figure 19 on 
page 55. The overlay tree structure shown in the illustration 
consists of nine segments residing in two regions; all 
references between segments are made using V-type address 
constants. Functions of ENTAB size determination are: 


Scanning the CESD for LR entries and entering their segment 
numbers. In Figure 19, item 6 is an LR item; its ID/length 
field points to the CESD entry for the control section in 
which it resides (line 3). The segment number contained in 
line 3 (segment number 3) is entered in the segment number 
field of the LR item. 


e Scanning the calls list, inserting chaining values that 
point from one group of R and P pointers to the next. 


° Scanning the calls list for each segment (starting with 
segment 1), and finding symbols referred to by that segment. 
For each reference found, the type of call Cupward, 
downward, or exclusive) is determined. If an ENTAB is 
required for the segment, its size is determined and a 
PC-delete entry for the ENTAB is made in the CESD. 
Referring to Figure 19, the segments are processed in the 


following manner: 

1. The calls list is scanned for P pointers that refer to J 
control sections in segment 1. If one is found, the 
associated R pointers (which refer to referenced 
symbols) are examined to determine the segment in which 
each referenced symbol resides. In Figure 19, the fifth 
P pointer refers to line 7 of the CESD, which contains 
an SD entry for a control section in segment 1. The 
associated R pointers refer to line 6 (symbol B in 
segment 3) and line ¢ Csymbol C in segment 5). For each 
reference, the type of call Cupward, downward, or 
exclusive) is determined, using SEGTA1 and the segment 
numbers of the calling and called segments. In 
Figure 19, SEGTA1 indicates that segment 1 is in the 
path of segments 3 and 5; therefore, the calls from 
segment 1 to B and C are downward calls. This is noted 
in the downward calls list by entering segment number 1 
in the lines referred to by the R pointer (lines 6 and 
4). Since segment 1 is the root segment, it must have 
an ENTAB; the size of the ENTAB is determined and a 
PC-delete entry for it is created in the CESD. 


2. When the scan for segment 1 is completed, the calls list 
1s scanned for P pointers that refer to segment 2. In 
Figure 19, the third P pointer in the calls list refers 
to CESD line 6, which contains segment number 3. In 
this case, however, no entry is made in the downward 
calls list because it indicates a call to B in segment 3 
from segment 1, which is higher in the path of the 
calling segment (Segment 2). No ENTAB is required for 
segment 2 because the reference to symbol B in segment 2 
can be resolved through the ENTAB entry in segment 1. 


3. The calls list is scanned for P pointers that refer to 3 


segment 3. In Figure 19, the fourth P pointer in the 
calls list refers to CESD line 3 (segment 3). The R 
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pointer refers to CESD line 8 (segment 8). SEGTAI 
indicates that the call from 3 to 8 is downward, across 
regions, and the call is noted in the downward calls 
list. Segment 3 requires an ENTAB, because it contains 
a downward call to a symbol not referred to by a segment 
in the path of the calling segment; the ENTAB size is 
determined, and a PC-delete entry for the ENTAB is 
created in the CESD. 


4. The calls list is scanned for P pointers that refer to 
segment ¢. In Figure 19, the first P pointer in the 
calls list refers to CESD line 9 (segment 4). The R 
pointers refer to line 2 (segment 2) and line 8 (segment 
8). SEGTAI indicates that the call from 4¢ to 2 is 
upward, while the call from ¢ to 8 is downward, across 
regions. The upward call is ignored, because the 
address constant can be resolved directly to the 
referenced symbol. The downward call from 4 to 8 is 
noted in the downward calls list, replacing the previous 
entry for segment 3 (because no segment with a segment 
number greater than ¢ can have segment 3 in its path). 
Because an ENTAB is required, the size is determined and 
a PC-delete entry is created in the CESD. 


This process continues until all segments have been 
processed. The required ENTABs are built during second pass 
processing (see "ENTAB Creation" and "Relocation of V-Type 
Address Constants in Overlay™). 
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Figure 19. ENTAB Size Determination 
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Entry Processing 


Entry processing includes the following operations: 


Entering in the alias table any alias symbols that were 
chained together and saved in the CESD by the ALIAS 
statement processor. Each entry in this table consists of 
an 8-byte symbol field and a 2-byte ESDID field. For each 
saved alias symbol, the entry processor scans the CESD for a 
matching SD or LR entry. If no match is found, a zero is 
placed in the ESDID field of the alias table entry for the 


-symbol. If a matching SD or LR entry is found, the ESD ID 


of the alias entry in the chain is placed in the ESDID field 
of the alias table entry for the symbol (see Figure 20 on 
page 57). The address assigned by linkage editor to the 
matching SD or LR and the ESD ID of its control section are 
placed in the CESD entry for the chained symbol, and the 
type of the chained symbol is changed to null. 


Determining whether the entry point was specified as an 
address on an END record, or as a symbol on an ENTRY 
statement or END record: 


1. If the entry point was specified as an address on an END 
record, the assigned address is determined by either 
absolute or relative relocation. If the ID on the END 
record referred to an ER which was resolved with an SD 
or LR, the address assigned by the linkage editor to the 
SD or LR is added to the address from the END record 
Cabsolute relocation). If the ID on the END record 
referred directly to an SD or PC, the relocation 
constant for the SD or PC is added to the address from 
the END record (Crelative relocation). 


2. If a symbolic entry point was specified on an ENTRY 
statement or END record, the CESD is scanned for a 
matching SD or LR symbol. The address of the matching 
symbol is used as the entry point. 


3. If no entry point was specified, the starting address of 
the SD or PC control section (not marked delete) with 
the lowest assigned address is chosen as the entry 
point. The entry point associated with the main name 
(not an alias) and all alias entry points must be in 
segment 1 if the program is in overlay. 


Assigning the addressing mode for the main entry point into 
the output load module. If the load module is in overlay 
format, the addressing mode is 24%; otherwise, the addressing 
mode is obtained from the CESD entry that defines the SD or 
PC that contains the entry address. The addressing mode, 
along with the entry address and the ESDID of the SD or PC, 
is saved in the all-purpose table. 


INTERMEDIATE OUTPUT PROCESSING 


56 


Intermediate output processing includes the following 
operations: 


Writing out the CESD on SYSLMOD in groups of 15 entries per 
record. The last record may consist of less than 15 
entries. In writing CESD records on to SYSLMOD, the 
intermediate output processor sets a flag in the control 
information indicating the content of byte 12 in the CESD 
entries in the record. If the CESD entries contain segment 
numbers (that is, the load module is in overlay format), the 
flag is off; if the CESD entries contain AMODE/RMODE data, 
the flag is on. 


Building and writing out the IDRs from the IDR tables 
CIDRTRTAB, IDRTITAB, IDRUDTAB, and IDRZPTAB) onto SYSLMOD. 
The On editor IDR is also built and written on to 
SYSLMOD. 
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° Building a half ESD (CHESD), consisting of the last 8 bytes 
of each CESD entry. (The symbol is deleted from each CESD 
entry to conserve virtual storage space during second pass 
processing.) The HESD is not complete at this time. (The 
ID of each label reference is used in building the scatter 
and translation tables. ) 


° Building and writing out the segment table (CSEGTAB), 
preceded by a control record describing it, if the program 
is in overlay. SEGTAB contains information required by the 
overlay supervisor. 


° Building and writing a one byte text record if the first 
load module text record does not begin at address 0. The 
l-byte text record is preceded by a control record 
describing it. 


° Building a scatter table and a translation table for a 
program that is to be scatter loaded and writing out 
scatter/translation records ina form acceptable to program 
fetch at execution time. The scatter/translation 
information is written out on SYSLMOD in 1024-byte records. 
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The first 4 bytes of each record are used to identify the 
records as scatter/translation information. If the length 
of scatter/translation information is greater than 1020 
bytes, the last 1020 bytes (plus 4 bytes of header 
information) are written out as the first 
scatter/translation record. The data in the last record may 
be 1020 bytes, or less (see Figure 21). In creating the 
scatter table entries, the RMODE/RSECT data is obtained from 
the HESD entries (byte 4) and inserted into the flag byte. 


Low-Order Position 
in Virtual Storage 


Beginning of 
Translation ————————_> 
Table 500 bytes 
Beginning of 4-byte header 
Scatter §——______» 1020 bytes 
Table 
a | 
1020 bytes A C 
1024 bytes 1024 bytes 1024 bytes 504 bytes 
1020 bytes 





— 


High-Order Position 
Sequential Order of Records 


in Virtual Storage 


Figure 21. Writing Scatter/Translation Records 


° Reading the TXT and RLD note lists into virtual storage if 
they were placed on SYSUT1 during TXT and RLD processing. 
The text note list may have been written a maximum of 11 
times and the RLD note list a maximum of 3 times on SYSUT1 
for a large program. The TTRs pointing to the locations of 
note list information are contained in the input/output 
control table in the all-purpose table. 


° Determining the control section containing the last text in 
the program (Cor in each segment, if the program is 
structured for overlay) and the highest segment number of 
the segments that contain text. (This information is 
necessary so that second pass processing can determine when 
to set the end-of-segment or end-of-module indicator.) The 
highest ESD ID is determined by scanning the text I/0 table 
for the ESD IDs of control sections that contain text. This 
ESD ID is entered into the high ID CHIID) table along with 
its associated segment number. 


° Determining, via bits in the all-purpose table CAPT), if the 
MAP option has ben specified or if the XREF option has been 
specified and all RLDs are in storage. If either of these 
conditions exists, the module map and/or the cross-reference 
table are produced. If the XREF option is specified and all 
RLDs are not in storage, XREF processing will be done as 
part of final processing. 


e If the ORDER option has been invoked during input 
processing, the text I/0 table and the text note list II 
(formed after merging all text note lists from SYSUT1) are 
sorted according to the ORDER table. The sorting, however, 
preserves the original order for those control sections that 
do not have entries in the ORDER table. 
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When MAP/XREF processing is performed as part of intermediate 
output processing, a table address is obtained from the APT, and 
a table of 2-byte entries pointing directly to the CESD is 
constructed. The CESD records for the current segment are 
gathered and sorted by address. The module map is then printed 
out; the map lists, in ascending order according to their 
assigned origins, all control sections contained in the output 
module and the entry points within the control sections. 

paseo: sections in an overlay output module are grouped by 
segment. 


If XREF processing is done during intermediate output 
processing, RLD items are incompletely relocated; their 
addresses are relative to the origins of their respective CSECTs 
rather than the origin of the load module, and the address of 
each RLD must be added to the linkage editor assigned address of 
its corresponding control section before the cross-reference 
table is produced. The cross-reference table includes a module 
map anda list of all references within a given segment that 
refer across control section boundaries. Each entry in the list 
contains the address of the reference, the symbol to which it 
refers, and the name of the control section in which the symbol 
is defined. For overlay programs, each item in the list also 
footer the number of the segment in which the symbol is 
afined. 


If the MAP and XREF options are processed during intermediate 
output processing, disposition messages and the diagnostic 
message directory are printed after the module map and 
cross-reference table. If the cross-reference table is produced 
during final processing, the disposition messages and the 
diagnostic message directory are printed before the 
cross-reference table. 





Second pass processing comprises modules HEWLFSCD and HEWLFREL. 


After intermediate processing is completed, the third phase of 
the linkage editor (second pass processing) begins operation 
soe Bagram 14). The major functions of second pass processing 
include: 


e Relocating address constants contained in the text. 
e Creating control/RLD records. 


e Writing TXT and control/RLD records on SYSLMOD in a format 
that can be loaded by program fetch. Included in the 
control information of the control or control/RLD record 
that precedes each text record is a count of the RLD and 
control/RLD records that follow the text record. This count 
is used by program fetch to build optional channel programs 
when loading the load module. 


e Creating ENTABs and associated RLD items for overlay 
modules. 


SINGLE PASS PROCESSING: Indicators residing in virtual storage 
in the text I70 table and the RLD note list are checked to 
determine whether text and RLD records have been written on 
SYSUT1 or have been retained in the input text buffer and the 
RLD buffer. If either text or RLD records have been retained in 
storage, Single pass processing is in effect for that record 
type. If two pass processing is in effect, the records are read 
into the buffers from SYSUT1. 


ORDERING OF TEXT: In two pass processing, the ID sequence in the 


text I/0 table is used to determine the order in which CSECTs 
are to be read into the second pass text buffer (which is 
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physically the same storage area as the input text buffer). The 
text I/0 table entry for each ID and the corresponding text note 
list entry are used to locate text on SYSUTI1 Csee Diagram 14, 
area A). Text is read into the buffer one multiplicity at a 
time, using the displacement field in the text note list to 
determine where within the buffer the text must be placed. 
Information about the text is entered into the second pass text 
control table, which is used to control subsequent processing of 
the text Carea B). 


SECOND PASS RLD BUFFERS: When the required text is in the text 
buffer, the corresponding RLDs are read into the RLD input 
buffer, using the RLD note list to locate the RLD records (area 
C). The RLD input buffer can contain two RLD records from 
SYSUT1; for each RLD input buffer area, an RLD input control 


block is maintained Carea D). The RLD output buffer is 768 


bytes long and is divided into three buffer areas (the maximum 
RLD output record is 256 bytes long); for each RLD output buffer 
area, an RLD output control block is maintained Carea F). While 
text 1s being relocated, the control record for that portion of 
text occupies one of the output buffers; the other two output 
buffers contain the relocated RLDs for the text being processed 
Carea E). If the relocated RLDsS exceed two buffers, the control 
record is written on SYSLMOD; relocated RLDsS may then be moved 
into the third output buffer. 


When all three RLD output buffers and the RLD input buffers are 
filled and additional RLDsS are required to relocate the text 
currently being processed, the contents of the output buffer 
must be written out. However, to maintain the required TXT/RLD 
sequence in the output module Carea G), the associated text must 
precede the RLD record. Space for the text is reserved in the 
output module by writing the incompletely relocated text; the 
contents of the RLD output buffer may then be written, and 
processing can continue. When the text is completely relocated, 
it is written over the space reserved for it, using the XDAP 
("execute direct access program") macro instruction. 


GROUPING SYSLMOD OUTPUT: As many CSECTs as will completely fit 
in one SYSLMOD record Cup to a maximum of 60) are grouped and 
written as one record. RLDs are grouped to correspond to the 
grouping of their associated text. If the overlay attribute is 
specified, only CSECTs belonging to the same segment will be 
grouped. 


If a CSECT is larger than the SYSLMOD record size, the CSECT is 
divided into multiplicities, each multiplicity being equal to 
the SYSLMOD record size. The length of the last multiplicity 
may be less than the SYSLMOD record size. Each multiplicity is 
written as a record, followed by RLDsS associated with only that 
multiplicity. 


Note: If the downward compatible attribute (DC) or the scatter 
format attribute (SCTR) is specified, CSECTs will not be 
grouped. 


END-OF-MODULE: When control sections for all segments of the 
output load module have been processed (determined via the "high 
ID™ indicator in the HESD type field and the "last segment with 
text" field in the all-purpose table), indicators are set in the 
last control/RLD record to mark it as the end of the module. 

The control/RLd record is written out on SYSLMOD, and second 
pass processing 15 completed. 


Note: If the output load module is to be structured for 
overlay, a list of relative track addresses (TTR list) is 
created to be used by program fetch when it loads the segments 
into virtual storage for execution. The TTR list contains one 
entry for each segment in the overlay load module. Each entry 
contains the relative track address of the first record (control 
record) of a segment, except for the first segment, which 


PC-delete control section that contains ENTAB entries in each 
segment where the text requires them and the RLD records 


contains the relative track address of the first text record. A 
P 
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required by program fetch to relocate address constants 
contained in the ENTAB entries are also created. 


Relocation of Address Constants 


There are two types of relocatable address constants: 
e Branch-type, such as DC V(X) 
e Nonbranch-type, such as DC A(X) 


The value of a branch-type or nonbranch-type address constant 
depends on a symbol in the CESD. To adjust an address constant 
to its proper value in the output load module, the linkage 
editor uses an absolute or relative relocation factor. The 
absolute relocation factor is the address assigned by the 
linkage editor to the symbol on which the value of the address 
constant depends. The relative relocation factor is the 
difference between the address assigned to the symbol by the 
linkage editor and the address of the symbol in the input 
module. The relative relocation factor may be positive or 
negative.?° The absolute and relative relocation factors of each 
symbol in the CESD are computed during address assignment and 
are saved in the half ESD CHESD). 


Relocation of Nonbranch-Type (A-Type) Address Constants 


A relative relocation factor is used for a nonbranch-type 
address constant if the symbol on which its value depends is in 
the same input module as the control section that contains the 
address constant. (The address constant and the symbol it 
refers to were assembled or compiled together, or were 
previously processed together by the linkage editor.) An 
example of relative relocation of nonbranch-type address 
constants is shown in Figure 22 on page 62. Because the address 
of DICK is known, the language translator places it in the value 
of the address constant. DICK is a known value prior to linkage 
editor processing (not an external reference in the input); 
therefore, a relative relocation factor (+1000) is used to 
relocate DICK during linkage editor processing. 





10 «6If it is negative, an indicator is set in the HESD to note 
that it is in complement form. 
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Legend: 
* Known value of DICK is inserted by language translator. 
t Relative relocation factor is +1000; linkage editor assigned address is 2000. 





Figure 22. Nonbranch-Type Address Constants—Relative Relocation 





address constant if the symbol referred to by the address 
constant does not have a defined value within the same input 
module. (The R pointer of the RLD item refers to an external 
reference.) An example of absolute relocation of a 
nonbranch-type address constant is shown in Figure 23 on page 
63. In this example, the value of SAM is unknown when input 
module 1 is processed by the language translator; therefore, 
zeros are placed in the value of the address constant. During 
second pass processing, the absolute relocation factor (the 
linkage editor assigned address) is used to relocate the address 
constant. 


An absolute r cation factor is used for a nonbranch-type 4 
> 
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* Language translator inserts zeros because value of SAM is unknown. 
+} Actua! address af SAM in the output module (0500) 1s added to value 


of address constant. 


( Figure 23. Nonbranch-Type Address Constants—Absolute Relocation 


Figure 24 on page 64 shows the use of both a relative relocation 
factor and an absolute relocation factor in relocating a symbol. 
Two input modules are to be processed by the linkage editor. 
Input module 1 contains a nonbranch-type address constant whose 
value depends on the symbol PETE; PETE is an external reference 
in the same module. The language translator has assigned a 
value of +10 to the address constant. The R pointer of the RLD 
item refers to the ER entry for PETE in the ESD; this entry 
contains zeros in the origin and length fields. The P pointer 
refers to the SD entry for the control section that contains the 
address constant. 


Input module 2 contains two control sections, BOB and PETE. BOB 
contains a nonbranch-type address constant whose value depends 
on PETE; because PETE has a defined value of (300) in the same 
module, the language translator has used that value to compute 
the value of the address constant (PETE + 10 = 310). The R 
pointer of the RLD item refers to the SD entry for PETE in the 
ESD; the P pointer refers to the SD entry for BOB (the control 
section that contains the address constant). 


During linkage editor processing, the ER and SD entries for PETE 
are merged into one CESD entry; the R pointers of both RLD items 
in the output module will refer to that entry. The RLD P 
pointer for the address constant in control section BILL will 
refer to the SD entry for BILL; the P pointer for the other 
address constant will refer to the SD entry for BOB. In the 
output load module, both address constants will contain the same 
value. Because the R pointer of the RLD item in input module 1 
refers to an ER entry in the ESD in that module, it is marked 
for absolute relocation; the absolute relocation factor for PETE 
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€+500) is added to the value (+10) assigned by the language 
translator. Because the R pointer of the RLD item in input 
module 2 refers to an SD entry in the ESD in module 2, it is 
marked for relative relocation; therefore, the relative 
relocation factor for PETE (+200) is added to the value (+300) 
assigned by the language translator. The relocated value for 
both address constants is 510. 


Relocation of all nonbranch-type address constants requires an 

addition or subtraction of the relocation factor to or from the 
value of the address constant in the text of the input module. 

CAddition or subtraction is specified in the flag field of the 

RLD item for the address constant. 
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Figure 24. Nonbranch-Type Address Constants—Absolute and Relative Relocation 
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DELINKING NONBRANCH-TYPE ADDRESS CONSTANTS: A relative 
relocation factor cannot be used to relocate an A-type address 
constant that refers to a symbol in a control section being 
replaced. Because the address constant has been previously 
relocated (by a language translator or by the linkage editor), 
it contains the value of a symbol being replaced; therefore, the 
value of that symbol must be subtracted from the value of the 
address constant. This process is called delinking. In 
delinking, an address constant is reduced to the value it would 
have contained if it referred to an external reference in the 
input module. After delinking, the address constant contains 
the value required for proper relocation, should the replaced 
symbol appear later in the input, in another control section. 
Delinked address constants are treated as address constants 
whose values depend on external references. (CAbsolute 
relocation factors are used in relocating them. ) 


Delinking of an A-type address constant is shown in Figure 25. 
Input load modules A and B both contain control section SAM. 
During linkage editor processing, the first occurrence of 
control section SAM is accepted, while the second occurrence is 
deleted through automatic control section replacement. 





ESD 


TXT 
RLD 


ESD 


TXT 


RLD 


C 

















Output Module 


oe fs 0 | | 100 | 
Bie «S| +1000 | | 800 | 
sam [8D] +1800 | | 750_ 

ur[risso |] 3 






LLIOHMN-+* 50) 
DC V (BH) 1000 





+1900 
DC ALIOHM+50) 


Linkage 
Editor 







Legend: 
* Values are derived from HESD. 
** 1100 + 800 = 1900. 

t 120 - 70 + 1850 = 1900. 

e A relative relocation factor is used to relocate the address constant A(JOHN+50) in 
control section JOE, because JOE and SAM are in the same module. 

e@ The address constant A(JOHN + §0) in control section BILL must be delinked because 
it was resolved with the symbol JOHN in the replaced control section SAM. The old 
value of JOHN must be subtracted from the value of the address constant before it 
can be relacated (using the absolute relocation factor) to the new value of JOHN in 
the output load module. 
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Figure 25. Example of Delinking 
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Control section BILL in module B contains a reference to symbol 
JOHN in control section SAM. Because SAM in module B will be 
deleted, the address constant A (JOHN+50)2 in module B must be 
delinked so that it may be properly resolved with the symbol 
JOHN in module A. In delinking, the old value of JOHN is 
subtracted from the value of the address constant in BILL 
€120-70=50). The absolute relocation factor for JOHN (1850) is 
then added to the delinked value of JOHN (50+1850=1900). 


DELINKING COMMON CONTROL SECTIONS: Common control sections 
Ceither blank common or named common) must be "delinked"™ by the 
linkage editor. All references to common control sections are 
made by means of nonbranch-type address constants. 


If the assigned address of a common control section in the input 
to the linkage editor is not zero, all such references must be 
delinked. Delinking is necessary, because during linkage editor 
processing all blank common control sections are collected into 
a single control section. All identically named common control 
sections are gathered into individual control sections; 
references to them from different input modules must be delinked 
s0 that they can be properly relocated with respect to the 
locations of the common control sections in the output module. 


Delinking adjusts the value of each address constant in a common 
control section so that it contains its correct displacement 
from the control section origin. The values of such address 
constants are then relocated so that they refer to the linkage 
editor-assigned addresses, using absolute relocation factors. 


Relocation of Branch-Type (V-Type) Address Constants 


Only absolute relocation factors are used to relocate 
branch-type address constants. Because a displacement is not 
allowed in the value of a V-type address constant, the absolute 
relocation factor is inserted in the value field during 
relocation. (CIt is not added to or subtracted from in value 
assigned by the language translator, as described for A-type 
address constants.) Because the value of a V-type address 
constant is inserted, delinking is never necessary for such 
address constants. Relocation of V-type address constants in an 
overlay structure is discussed in the following paragraph. 


RELOCATION OF V-TYPE ADDRESS CONSTANTS IN OVERLAY: If the output 
of the linkage editor is to be overlay load module, a 4-byte?? 
branch-type address constant in the path of the symbol it refers 
to (but in a different segment), or ina different region, will 
be relocated in a special manner. The value field of the 
address constant will contain the address of an ENTAB entry. 

The ENTAB entry will contain the address assigned by the linkage 
editor to the symbol referred to by the value of the address 
constant. An ENTAB entry is created for each V-type address 
constant that is in the path of the symbol it refers to (but is 
not in the same segment), or located ina different region, 
provided that the symbol is not referred to in a segment higher 
in the path of the calling segment. (Such address constants are 
resolved so that they refer to the ENTAB entry previously 
created for the symbol in the higher segment.2 ENTAB entries 
are not created for address constants that refer to symbols 
higher in the path. Whenever an ENTAB entry is created, it is 
noted in an entry list; each item in the entry list contains the 
entry number of the referenced symbol in the HESD, the segment 
number of the calling segment, and the address assigned to the 
ENTAB entry by the linkage editor. The ENTAB creation routine 


11 Any address constant must be 4 bytes, because the high-order 


byte is used by the overlay supervisor during execution. 
The number of the segment containing the address constant 
will be placed in the high-order byte of any V-type address 
constant resolved to an ENTAB entry. (The high-order byte 
must be zero if it is not resolved to an ENTAB entry.) 
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uses the entry list to build ENTAB entries (see "ENTAB 
Creation™). 


When second pass processing begins to process a segment, the 
entry list is modified so that is contains only entries for 
segments higher in the path of the current segment. (In 

Figure 26, segment 4 is being processed; the entry for segment 3 
is removed, because it is not higher in the path of segment 4.) 


Entry List 


HESD 5 
Entry — Address 
Number ss 


} 









Next 
available 
line; 4 
will be 
entered 
here, 





Current 
Segment 


3 





Figure 26. Entry List Processing 


During relocation, each V-type address constant is examined to 
determine if an ENTAB entry must be created for it. The R 
pointer of the RLD item for the address constant is used to find 
the associated HESD entry; this entry contains the segment 
number of the symbol referred to by the address constant. The 
relationship of this segment to the current segment is then 
determined, using SEGTA1. Depending on the relationship in 
SEGTA1, the address constant is relocated in one of three ways: 


1. If the segment that contains the symbol is higher in the 
path of the current segment, the call is upward and the 
address constant is resolved directly. (The absolute 
relocation factor of the symbol is inserted in the value of 
the address constant. ) 


2. If the current segment is higher in the path of the segment 
that contains the symbol, the call is downward. The entry 
list is checked to determine if an ENTAB entry was 
previously created for the symbol in this segment or ina 
segment higher in the path of this segment. If an ENTAB 
entry for the symbol exists, its address (contained in the 
entry list) is placed in the value field of the address 
constant. If no ENTAB entry exists for the symbol, a new 
entry is placed in the entry list, and an ENTAB entry will 
be created by the ENTAB creation routine (see "ENTAB 
Creation™). The ENTAB entry will contain the address 
assigned to the symbol by the linkage editor, and the 
address of the ENTAB entry will be placed in the value of 
the address constant and in the entry list item. 


3. If neither of the two segments is higher in the path of the 
other, the call is either exclusive or across regions. If 
the two segments are in different regions, and no ENTAB 
entry already exists for the symbol in the entry list, an 
ENTAB entry will be created and an entry is made in the 
entry list; the value field of the address constant is 
relocated to the address of the ENTAB entry, which in turn 
contains the relocated address of the symbol. If the two 
segments are in the same region, the call is exclusive. If 
there is an entry in the entry list for the symbol, the 
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ENTAB Creation 


Relocation Routine 


address constant is resolved through its ENTAB entry; if 


there is no entry for the symbol in the entry list, the call 


is an invalid exclusive call and the address constant is 
resolved directly to the symbol. (This usually leads to 
incorrect results during execution of the module. ) 


The ENTAB creation routine uses the size field in the HESD to 
determine the number of ENTAB entries to be created for a given 
segment. The entry list is scanned for all entries that were 
created for the current segment; each of these entries contains 
the HESD entry number for the corresponding symbol. The value 
and segment number of the symbol are obtained from the HESD and 
are entered in the ENTAB entry, along with standard information 
shown in the table format (see "Table Layouts™). 


ENTAB creation is shown in Figure 28 on page 70. The V-type 
address constants referring to SAM and BILL in segment 1 meet 
the requirements for building ENTAB entries. The ESD and RLD 
input to the second pass processor, and the overlay tree 
structure are shown in Diagram A. During relocation, entries 
are created for SAM and BILL in the entry list (see Diagram B); 
each entry contains the address of the ENTAB entry created for 
the address constant. 


In segment 1, location 136 of control section JOE contained a 
call to control section SAM before relocation. After 


relocation, location 136 contains the address of the ENTAB entry 


for SAM, and the high-order byte of the address constant 
contains the segment number of the calling segment. An ENTAB 
entry is created, in like manner, for BILL in segment 1. 


In segment 2, the address constant referring to BILL does not 
meet the requirements for building an ENTAB entry. CIt is not 
in the path of the segment containing the symbol.) Therefore, 
no ENTAB is created in segment 2. The call for segment 2 to 
BILL in segment 3 is an exclusive call. Because a call to the 
same symbol appears in a higher segment common to 2 and 3 
(segment 1), the address constant may refer to the ENTAB entry 
for BILL in segment 1. (This is determined by scanning the 
entry list for the HESD entry corresponding to the symbol BILL.) 


If a call to BILL was not contained in a common segment, the 
address constant DC V (BILL) in segment 2 would be resolved 
using the value assigned by the linkage editor to the symbol 
BILL, which results in an error. 


In segment 3, the address constant is an upward call and is 
resolved directly. 


The relocation of address constants is performed by the 
epee ton routine; the routine operates on the following input 
ata: 


e The address of the RLD input buffers that contain RLD 
records. 


e The address of the RLD note list entry for the RLDs being 
processed. 


e The address of the next available entry in the RLD output 
buffer. 
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° The buffer relocation constant (BRC) where: 


BRC = starting buffer address of current text + relative 


C 


multiplicity size x current multiplic 


relocation constant of current control section - address 
assigned to current control section by the linkage editor - 


ity number. 


Output 


Action Performed 


OOOOLLST Absolute Absolute relocation OOOOLLST 
factor is added to 
value of address 
constant 


OOO01LLST Branch Absolute relocation OOO1LLST 
factor is inserted 
into value of 
address constant 


OOLOLLST PR displacement Absolute relocation OOLOLLST 
value factor is inserted 
CPR type 1) into value of 
address constant 


OOLOLLST PR cumulative PR length from all OO011LLST 
displacement purpose table is 
value inserted into value 
CPR type 2) of address constant 


1OO0O0LLST Relative Relative relocation OOO0OLLST 
factor is added to 


value of address 
constant 


( Figure 27. Relationship of RLD Flag Field to Relocation 


Notes to Figure 27: 


l. If S (sign) in LIST is 1, subtraction 
than addition. 


2. In delink type, the delink value is a 
according to the opposite of the sign 





Type 


PR displacement 
value 


PR cumulative 
displacement 
value 


is performed, rather 


dded or subtracted 
; the absolute 


relocation factor is added to or subtracted from the address 
constant according to the indicated sign. 


3. If an RLD item refers to an undefined symbol, the associated 


address constant is not relocated. ( 


It may have been 


delinked.) The high-order bit of the RLD item flag field is 


set to one C1LOOOLLST for an A-type co 
V-type constant) and no relocation wi 
the module is loaded into virtual sto 


4. Delinking is noted in the high-order 


nstant, LOOILLST for a 
ll be performed when 
rage for execution. 


bit of the P pointer. 


Method of Operation 69 


rae pocumant contains restricted materials of IBM. © Copyright IBM Corp. 1972,1983 
26- _ 





i 036 | JOE 
Diagram A, HESD 
L.E. Relocation 136 | DC V(SAM)* Segment | 
Assigned Constant i 
Type Address Seg Length Table 186 | DC V(BILL) 


272 [SAM BILL 
Segment 2 Segment 3 


DC V(BILL) DC V(JOE) 





Structure with V-type address 
Constants. 
* Zero value assigned by the assembler. 








Diagram B. 


Output RLD Buffer Entry List Entab RLD Items 


pt D240 
ee EE eee ae 


P 
; 
— 
oO 
Nm 
a 
[ee] 


RLDs and Entry List after relocation for control section JOE. 





Diagram Cz 


Segment 1 after processing by Second Pass Processor. 








JOE 
01000236 

DC V{SAday 
01000248 

DC viputy 










236 
248 
260 


47FF 0024 00000272 | 02 [| 000000 —is| 
47FF 0012 00000 272__| 03 | 000000 
Standard Last ENTAB Entry 


ENTAB 








Diagram D. 
Segment 2 after processing by Second Pass Processor. 
272 =| SAM 


02000248 
752, «| DC ViBRty 


Input RLD Buffer Output RLD Buffer ENTAB RLD Items Entry List 


(ak es ee eT NC (Ser 


* Same as after processing segment |. 





Diagram E. 
Segment 3 after Second Pass Processing 
BILL 
00000036 
DC VULeFT 
Input RLD Buffer Output RLD Buffer ENTAB RLD Items Entry List 
eae Cee pee 


* Same as after processing segment | 


Figure 28. ENTAB Creation 
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The relocation routine operates in the following manner: 


1. The size of the RLD set!? and the displacement from the 
beginning of the buffer are determined from the RLD note 


list. 

2. Each RLD item in the current RLD set is scanned to determine 
whether: 
a. It describes an address constant for the current text 


being processed (BRC + address contained in the RLD 
address field falls within the text buffer boundaries of 
the current text.) 


b. The address constant is either a valid 2~-, 3-, or 4-byte 
address constant. (The only valid 2-byte address 
constants are defined by pseudo register symbols.) 


3. Each address constant whose RLD meets the above requirements 
is moved from the text into a computation area. The address 
constant associated with the RLD item is then relocated 
according to the information in the flag field of the RLD 
item (see Figure 27 on page 69). In relocating 4¢-byte 
address constants (VCONS), the high-order bit in the address 
constant before relocation is reproduced in the address 
constant after relocation. The relocated address constant 
1s then placed back into the text. 


4. The RLD address field is updated using the relative 
relocation factor for the control section being processed. 
(The control section referred to by the P pointer of the RLD 
1tem). 


5. The RLD is moved into the RLD output buffer if space is 
available. If space is not available, the contents of the 
RLD output buffer are written out on SYSLMOD. See "Second 
Pass RLD Buffers™ under "Second Pass Processing." 


6. Steps 2 through 5 are repeated until all RLD items have been 
scanned in the RLD set being processed. The multiplicity 
number in the RLD note list is updated if unprocessed RLDs 
remain in the set. 


7. d3If there are more RLD sets in the input buffer to be 
processed, the address of the next record is determined and 
steps 1 through 6 are performed. 


Note: To minimize the number of times RLD records are read from 
SYSUT1, RLD records for a control section are held in the input 
RLD buffer, when possible, until all RLD records in the buffer 
have been processed (because each RLD record may pertain to many 
multiplicities of text). After each set of RLDs is scanned, the 
multiplicity number in the RLD note list is updated to reflect 
the multiplicity of the remaining unprocessed RLD records in the 
set. An RLD record is removed from the buffer when: 


® All RLD items in the record have been processed. (Their 
associated address constants have been relocated. ) 


° Another RLD record must be read into the buffer and space is 
not available. 


When all records in the input RLD buffer have been scanned, the 
relocation routine determines if more RLD records for the 
current multiplicity of text are to be read in. (The RLD read 
routine sets an indicator when it encounters such a record but 
cannot read it into the buffer because the buffer is full.) 

When both buffers are full, the second buffer is freed, anda 
bit is set in the corresponding RLD note list entries which 
indicates that the RLDs are not in virtual storage. The records 


12 An RLD set is a group of RLDs referred to by a particular 


RLD note list entry. 
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to be read in are then placed in the second RLD buffer; these 
records are processed in the same manner as those already 
residing in the first buffer. This process is repeated until 
all records that contain RLD items pertaining to the current 
multiplicity of text have been scanned and processed. 


When all RLDs in a buffer are processed, the buffer is marked 
"free”™ in the RLD control block. When a new multiplicity of 
text 1s to be relocated, the RLd note list is scanned 
sequentially Con ID and multiplicity number) from the first 
entry. If an entry indicates that the record is "in virtual 
storage" and the record contains RLD items pertaining to the new 
multiplicity of text, it is processed. 


FINAL PROCESSING CHEWLFFNL ) 


Error Logging 


Final processing comprises modules HEWLFFNL, HEWLFBTP, and 
Coptionally) HEWLFMAP. 


The fourth phase of the linkage editor (final processing) 
performs "cleanup" functions, and is the last operation of the 
eee editor processing. Functions of final processing 
Include: 


e Writing the TTR note list, created during second pass 
processing, on SYSLMOD if the output load module is to be 
used in overlay. The TTR list contains the relative track 
address of the first record of each segment of the overlay 
load module. It is used by the overlay supervisor to find 
the segments when it loads them into virtual storage for 
execution. 


e Placing each entry itn the proper format for the partitioned 
data set directory, modifying it if there are alias symbols, 
and issuing a STOW macro instruction!* for the member name 
and each alias. 


e Checking attributes (reusable, reenterable, and 
refreshable). If the attributes have become more 
restrictive, a message describing the change in attributes 
15 printed out. (CFor example, the input module was 
specified as "reusable" and is now "not reusable.™) 


e Printing out a directory of logged errors. 


° Producing a cross-reference table if the XREF option is 
specified, and the cross-reference table was not produced 
during intermediate output processing. 


° Printing a diagnostic message if the module has been marked 
"not executable." 


° Reinitiating linkage editor processing, beginning with 
initialization, if a NAME statement terminated SYSLIN input. 


e Completing linkage editor processing if end-of-file 
terminated SYSLIN input; releasing virtual storage and 
returning control to the caller. 


Whenever an error condition is detected during linkage editor 
processing, an indicator jis set in an error logging map and a 
coded diagnostic message is printed out. During final 
processing, the error logging map is scanned. When an indicator 


13 The STOW macro instruction is not issued if there was no 


valid input, if there were no ESDs, if nothing was written 
out on SYSLMOD, or if the run was terminated by a severity 4 
error. 
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C 


is found "on" in the map, an associated list is used to build a 
diagnostic message. 


Note: An example of error logging is given in Figure 29. Each 
entry in the list contains a length indicator and a pointer to a 
phrase to be assembled into the message. (Phrases are stored to 
save virtual storage space; complete messages would require 
additional space because of repetition of identical phrases. ) 
The diagnostic directory is then printed out, one or two lines 
to a message. This directory is normally directed to the 
SYSPRINT data set. However, if the TERM option was specified, 
diagnostic messages are directed to both the SYSPRINT and 
SYSTERM data sets. 


Error Logging Map 


emer eee ieee 


Table 


“— 
——— 
_ 


: | | X | | 


™“ — 
a“ me 


Phrases 


Messoge 


a 


Legend: 
* This pointer is determined by subtracting the bit number from the length 
of the error logging map (64 - 16 = 48). 


Figure 29. Building Error Messages 


All error messages produced by the linkage editor are identified 
by a message ID having the format: 


IEWDMMS 

where: 

IEW identifies the message as a linkage editor error message. 

D contains a zero. 

MM is the message number. 

Ss 1s the severity code. 

The module in which an error message occurred is identified by 

the message number (MM; see Figure 68 on page 189). 
Cross-Reference Table 

If the XREF option is specified, and the cross-reference table 

Was not produced during intermediate output processing, the RLD 

records are read back from SYSLMOD, and the cross-reference 


table is built, as described in the discussion of intermediate 
processing. 
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Text I/O Table @) 











a ae Text Note List 
Po [0 | 7aco | o6ac | 
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Text Records 
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Table (RNT) 


First Pass RLD Buffer 





Input Text Buffer (TXTBFBEG) 


760 ee pi te bo TXTBFBEG 
| Text Dero | [txt] 


Mult 


Disp 


Text Dota 


Addr 


Contents Written 
When Buffer Is Full 





Legend: 


The ID in the first control record is renumbered. 
The third line of the RNT contains o 4, so the ID 
is renumbered to refer to the fourth line of the 


CESD (CSECT DD). 


Assuming CSECT DD (CESD ID 4) is not to be 


deleted, its length (in the control record) is checked. 


If the entire CSECT or ao complete multiplicity will 
Fit in TXTBFBEG, the record containing text for DD 
is read into TXTBFBEG, and entries are made in the 
text |/O table and the text note list*. 


Each subsequent control record is processed. Text 


records are read into TXTBFBEG until it becomes full, 


at which time its contents are written onto SYSUTI. 


In the two text records in this example, the multi- 
plicity number is 0, because they are the first text 
records for their respective control sections. 
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RLD Note List 





ID Mult Length Addr/ 
Disp! 


Legend: 
Register 6 initially points to the firsg RLD input record. 


e 

@ RLD records are grouped in the RLD buffer by P pointer. In this example, the first 
and second, and third and fourth RLD records are grouped. 

e@ Rand P pointers are renumbered, using the renumbering table, as RLD records are 
moved into the buffer. 

e Entries for each RLD set are made in the RLD note list. Length and displacement 
fields refer to the first record of the set. 

e@ When the contents of the RLD buffer are written, the displacement field of the RLD 
note list entry for the last set included in the output record is replaced by the relative 
track address (TTR) of the SYSUTI record. 
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PROGRAM ORGANIZATION 


3 


The following text and the flowcharts at the end of this section 
describe the processors (code modules, control sections, and 
routines) that accomplish the functions of the linkage editor. 
The organization of this section corresponds to the organization 
of the linkage editor; descriptions of all processors that 
constitute a phase of the linkage editor are grouped together. 
For each processor, the symbolic name is given to facilitate use 
of program listing (see "Microfiche Directory") and the 
descriptive name is given to facilitate reference to "Method of 
Operation.” 


Figure 31 on page 96 shows the overall organization of the 
linkage editor; this illustration is designed to help determine 
relationships among the processors described in this section. 


INITIALIZATION AND INPUT PROCESSING 


Initial Processor——HEWLFINT (Chart BA) 


Entrance: HEWLFINT is entered from HEWLFROU at the beginning of 
linkage editor processing. 


Operation: HEWLFINT performs initialization functions, including 
building the all-purpose table (CAPT), analyzing attributes and 
options passed by the calling program, opening data sets, and 
allocating virtual storage for buffers and work areas. 


Routines Called: HEWLFINT calls the attributes and options 

processor CHEWLFOPT) and the allocation routine (ALL001). The 
HEWLFINT routine is recalled immediately upon returning from the | } 
first call of the allocation routine CALLOO01). 


Exits: When initialization is completed, HEWLFINT passes control 
to the input processor (HEWLFINP). 

Attributes and Options Processor-——HEWLFOPT 
Entrance: HEWLFOPT is entered from the initial processor. 
Operation: HEWLFOPT analyzes the options requested and the 
attributes specified by the calling program, and notes this 
information in the APT. If a valid authorization code is found, 
it is converted to binary and stored in both the default field 
and the PDS entry field of the APT. 


Routines Called: None 


Exits: When attribute and option processing is completed, 
HEWLFOPT returns control to the initial processor CHEWLFINT). 





Allocation Processor-—ALL001 (Chart BA) 
Entrance: HEWLFOPT is entered from the initial processor. 


Operation: ALLO01 issues the GETMAIN macro instruction and 
assigns storage to buffers. 


Routines Called: ALLOOI calls the table allocation processor 
CHEWLFALK) to allocate storage for fixed-length and 
variable-length tables. 


Exits: When allocation processing is completed, ALLO001 returns J 
control to the initial processor CHEWLFINT). 
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Table Allocation Processor——HEWLFALK (Chart BB) 


Entrance: HEWLFALK is entered initially from ALLO01 after 
storage has been allocated for the buffers. It is entered a 
second time for reallocation of tables. 


Operation: HEWLFALK assigns storage to the internal tables. In 
initial allocation, HEWLFALK assigns only the minimum required 
storage to the tables. A note is made of the highest address 


used in the initial allocation. Reallocation occurs 
unconditionally. HEWLFALK determines the amount of storage in 
excess of the minimum required. This excess is used to expand 


proportionately the variable-length tables. 
Routines Called: None 


Exits: When table allocation processing is completed, HEWLFALK 
returns to the calling routine. 





Input Processor—~~“HEWLFINP (Chart CA) 


Entrance: HEWLFINP receives control from the initial processor 
when all initialization functions are completed. 


Operation: HEWLFINP reads and initially processes all linkage 
editor input. Input type Cobject module or load module) and 
Input conditions are determined, and control is passed to 
appropriate processors. 


Routines Called: HEWLFINP calls the following processors: 


e Control statement scanner (HEWLFSCN) when a control 
statement 1s detected (blank in column 1) 


e Object module processor (CHEWLFMDI) when object module input 
1s detected (SYSLIN input or fixed (CF) format input from 
SYSLIB) 


e Load module processor CINP270) when load module input is 
detected Cundefined (U) format input from SYSLIB) 


e Include processor CHEWLFINC) at end-of-input if more modules 
must be included 


e Automatic library call processor CHEWLCAUT) at end-of-input 
on SYSLIN if the NCAL option is not specified 


Exits: When input processing 1S completed, HEWLFINP passes 
control to the address assignment processor (HEWLFADA), if valid 
input was received. If no valid input was received, control is 
passed to the final processor CHEWLFENL) to terminate linkage 
editor processing. 


Object Module Processor—~—HEWNLFMDI (Chart CB) 


Entrance: HEWLFMDI is entered from the input processor when 
object module input is detected. 


Operation: HEWLFMDI determines the input record type (SYM, TXT, 
RLD, ESD, END), loads input record infromation into general 
registers, and passes control to the appropriate processors. 


Routines Called: Depending on input record type, HEWLFMDI calls 
the following processors: 


SYM processor CHEWLFSYM) 
ESD processor (CHEWLFESD) 
END processor CHEWLFEND) 
Text and RLD processor CHEWLFRAT) 
IDR processor CHEWLFIDR) 
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Exits: When object module processing 1s completed, HEWLFMDI 
returns control to the input processor. 


Load Module Processor—“INP270 (Chart cc) ) 


Entrance: INP270 is entered from the input processor when load 
module input is detected. 


Operation: INP270 determines the input record type (TXT, CESD, 
scatter/translation, SYM, CCW, CCW/RLD, RLD, IDR), loads input 
record information into general registers, and passes control to 
the appropriate processors. 


Routines Called: Depending on input record type, INP270 calls an 
associated processor, as shown 1n Figure 30. 


Exits: When load module processing is completed, INP270 returns 
control to the input processor. 


TXT HEWL FRAT 
CESD HEWLFESD 
Scatter/translation (Ignored) 


SYM HEWLFSYM 
CCW HEWL FRAT 
CCW/RLD HEWL FRAT 
RLD HEWL FRAT 
IDR HEWLFIDR 





If end-of-module indicator is on: 


HEWLFEND J 


HEWLFEND 
HEWLFEND 





Figure 30. Load Module Record Types and Associated Processors 


SYM Processor~—"HEWNLFSYM (Chart CD) 


Entrance: HEWLFSYM is entered from the object module processor 
when SYM records have been detected and the TEST attribute has 
been specified. If TEST is not specified, SYM records are 
ignored. 


Operations: HEWLFSYM gathers SYM records in the RLD input 
buffer, and writes the buffer contents on SYSLMOD when the first 
TXT record of a module is detected. 

Routines Called: None 


Exits: When SYM processing is completed, HEWLFSYM returns 
control to the object module processor. 
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ESD Processor~“HEWLFESD (Chart CE) 


Entrance: HEWLFESD is entered from the object module processor 
when an ESD record is detected, and from the load module 
processor when a CESD record is detected. 


Operation: HEWLFESD combines ESDs in the linkage editor input 
into a composite ESD. Matching input symbols are resolved, and 
specified operations Creplace, change, delete) are performed on 
the symbols. A renumbering table (RNT) is produced to allow 
input ESD IDs to be translated into CESD IDs. 


Exits: When ESD processing is completed, HEWLFESD returns 
control to the routine from which it was entered (object module 
processor or load module processor). 


Text and RLD Processor—~—“HENLFRAT (Chart CF) 


Entrance: HEWLFRAT is entered from the object or load module 
processors when a text or RLD record is detected. 


Operation: HEWNLFRAT determines record type (TXT or RLD), checks 
for error conditions Cinput record larger than buffer), and 
passes control to the appropriate processor. 


Routines Called: Depending on the record type, HEWLFRAT passes 
control tuo either the text processor CHEWLFITXT) or the RLD 
processor CRLDOQO1). 


Exits: When text and RLO processing is completed, HEWLFRAT 
returns control to the object or load module processor. 


Text Processor—~“HEWLFTXT (Chart cG) 


Entrance: HEWLFTXT is entered from the text and RLD processor 
when a text record is detected. 


Operations: HEWLFTXT operation depends on whether text input 15s 
from object or load modules. Object module text is moved from 
the object module buffer to the input text buffer, and must be 
arranged in the proper order. Load module text input is already 
ordered, so HEWLFITXT reads it directly into the input text 
buffer. In either case, the input text ID is renumbered to 
refer to the CESD ID of the appropriate control section. When 
the input text buffer becomes full, its contents are written on 
SYSUT1. 


Routines Called: When the input text buffer is full, HEWLFITXT 
calls the text write routine (TXTBUF—Chart CH) to write the 
buffer contents on SYSUT1. 


Exits: When text processing is completed, HEWLFTXT returns 
control to the text and RLD processor. 


RLD Processor~~RLDOO1] (Chart CJ) 


Entrance: RLDOO1 is entered from the text and RLD processor when 
an RLD record is detected. 


Operation: RLDOOLl groups RLD items in the RLD buffer and 
renumbers the R and P pointers to refer to appropriate CESD 
entries. Each RLD item is processed according to its flag and 
address (FA) field. RLDO01 also creates an RLD note list, with 
entries for each set of RLDs (a set being all RLDs having the 
same P pointer). If either the RLD buffer or the RLD note list 
becomes full, the contents of the buffer and the note list are 
written on SYSUT1. 


Routtnes Called: When the RLD buffer or the RLD note list is 


full, RLDOO1 calls the RLD write routine (RLDBUF—Chart CK) to 
write the note list and the buffer contents on SYSUTIL. 
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Exits: When RLD processing is completed, RLDQO1 returns control 
to the text and RLD processor. 


End Processor——HEWLFEND (Chart CL) ») 


Entrance: HEWLFEND is entered from the object or load module 
processor when an END record or the end of a load module is 
detected. 


Operation: HEWLFEND resets tables involved in input processing, 
processes entry point information, deletes CESD lines marked 
Wchain™ or “delete,™ and enters in the CESD the length of 
control sections for which no length was previously indicated. 


Routines Called: None 


Exits: When end processing is completed, HEWLFEND returns 
control to the object or load module processor. 


CSECT Identification Record (IDR) Processor-—HEWLFIDR (Chart CQ) 


Entrance: HEWLFIDR is entered from the input processor, 
HENWLFINP, to process object module END records and load module 
identification records. It is also entered from HEWLFSCN for 
processing IDENTIFY control statements. 


Operation: HEWLFIDR takes IDR information from the input records 
and enters this data in the appropriate IDR table. 


Routines Called: Error and informative messages are processed by 
calling HEWLFLOG. 


Exits: When IDR processing ends, HEWLFIDR returns to the calling 
program. 


Control Statement Scanner——HEWLFSCN (Chart CS) J 


Entrance: HEWLFSCN is entered from the input processor when a 
control statement is detected. 


Operation: Depending on the type of control statement being 
processed, the control statement scanner makes entries in the 
APT, SEGTA1, and/or the CESD. This information is used to 
control subsequent linkage editor processing. 


Routines Called: HEWLFSCN calls the READ8& routine (Chart CT) to 
process control statement operands. 


Exits: When control statement processing is completed, HEWLFSCN 
passes control to the include processor CHEWLFINC), if an 
INCLUDE control statement was processed Cinclude chain built in 
the CESD). OQOhterwise, HEWLFSCN returns control to the input 
processor. 


Include Processor——"HENLFINC (Chart CU) 


Entrance: HEWLFINC is entered from the input processor when 
"more includes” are indicated at end-of-input, and from the 
control statement scanner when an INCLUDE statement has been 
processed. 


Operation: HEWLFINC examines the inelude chain in the CESD and 
selects the next module to be included. It opens the data set, 
determines the attributes of the module to be included, and 
initializes the DCB to allow the module to be read. 


function has been requested is not contained in the specified 
library, HEWLFINC calls HEWLFEND to delete the corresponding 
CESD lines. 


Routines Called: If a module for which the REPLACE/CHANGE ) 
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Exits: When include processing is completed, control is returned 
to the input processor. 


Cc Automatic Library Call Processor-—~“HEWLCAUT (Chart Cv) 


Entrance: HEWLCAUT is entered from the input processor at the 
end of SYSLIN input, or when a NAME statement has been detected 
(provided that the NCAL option was not specified). 


Operation: HEWLCAUT first scans the CESD for unresolved ERs 
specified on LIBRARY statements. It attempts to resolve these 
ERs by searching the PDS directories of ddnames included in 
library chains, allowing the members found to be read. A second 
CESD scan attempts to resolve ERs not specified on LIBRARY 
statements by attempting to call them from SYSLIB. 


Routines Called: After the first series of CESD scans, HEWLCAUT 
returns control to the input processor to read the members. 


Exits: After the second series of CESD scans, HEWLCAUT passes 
control to the address assignment processor CHEWLFADA). 


INTERMEDIATE PROCESSING 


Address Assignment Processor——HEWLFADA (Chart DA) 


Intermediate Output 


Entrance: HEWLFADA is entered from the input processor when 
input processing is completed 


Operation: HEWLFADA assigns linked addresses to all CESD 
entries, determines the size of SEGTAB if the program is in 
overlay, determines if the first text record does not begin at 
address 0, determines the number of ENTAB bytes required for 
each segment, builds the alias table, and determines an entry 
point for the program. 


Routines Called: HEWLFADA calls the ENTAB size determination 
routine CHEWLFENS—Chart DB) to compute the size of ENTAB, and 
calls the entry processor (HEWLFENT——Chart DC) to build the 
alias table and determine an entry point. 


Exits: When address assignment processing is completed, HEWLFADA 
passes control to the intermediate output processor CHEWLFOUT). 


ProcessSor"~HEWLFOUT (Chart EA) 


Entrance: HEWLFOUT is entered from HEWLFADA when address 
assignment processing is complete. 


Operation: HEWLFOUT writes the following on SYSLMOD; CESD, 
SEGTAB (for programs in overlay), and scatter/translation 
records (for programs to be scatter loaded). If a HIARCHY 
statement is specified, storage hierarchy designations are 
included in the scatter/translation records. If the MAP option 
has been specified, a module map 15 produced and written on 
SYSPRINT; if the XREF option has been specified and all RLDS are 
in storage, a cross-reference table is produced and written on 
SYSPRINT. 


If the TXT and RLD note lists were placed on SYSUT1 during TXT 
and RLD processing, HEWLFOUT reads them back into storage, and 
builds the high ID table (HIID). The half ESD CHESD) is also 
built, after the CESD has been written. 


Routine Called: HEWLFOUT calls the MAP/XREF processor (CHEWLFMAP) 


to produce and write the module map and cross-reference table, 
if requested. 
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Exits: When intermediate output processing is completed, control 
is passed to the second pass processor CHEWLFSCD). 


OND PASS PROCESSING ») 


Second Pass Processor~"HENLFSCD (Chart FA) 


Entrance: HEWLFSCD is entered from HEWLFOUT when intermediate 
output processing is completed. 


Operation: HEWLFSCD performs the following functions: 
e Reads text from SYSUT1. 

° Relocates address constants contained in the text. 
e Creates control/RLD records. 


® Writes text and control/RLD records on SYSLMOD in a format 
that can be loaded by program fetch. 


e Creates ENTABs and associated RLD items for overlay modules. 


Routines Called: During second pass processing, HEWLFSCD calls 
the following routines: 


e Control section search routine (GETIDMUL—Chart FB) to 
determine the next ID and multiplicity to be processed. 


e Text and RLD read routines (RDTXT, RDRLD-—-Chart FC) to read 
required text and RLDs from SYSUT1. 


e Text write routine (WRTTXT—Chart RD) to write text on 
SYSLMOD CHEWLMSIO). 


e Control/RLD record write routine CWRTICRRLD) to write RLDs ») 
and control records on SYSLMOD CHEWLFSIO). 


e Second pass initialization routine CHEWLFREL~—Chart FE) to 
initialize text and RLD control blocks. 


e Relocation routine CRELOCATE—Chart FE) to relocate address 
constants (branch-type and nonbranch-type) in the text. 


e Common path routine CHEWLCPTH) to determine common segments 
in an overlay path. 


ENTAB creation routine (SCDENTAB) to create ENTAB items for 
each segment. 


Exits: When second pass processing is completed, control is 
passed to the final processor CHEWLFFNL). 


Final Processor—“HEWLFFNL (Chart GA) 


Entrance: HEWLFFNL is antered from HEWLFSCD when second pass 
processing is completed. 


Qperation: HEWLFFNL performs the following "cleanup™ functions: 
e Writes the TTR list for overlay modules on SYSLMOD 


® Places entries in the partitioned data set directory and 
issues a STOW macro instruction } 


e Prints a directory of logged errors 
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e Checks for more restrictive module attributes 


e Produces a cross-reference table if it was requested and not 
produced during intermediate processing 


Routines Called: During final processing, HEWLFFNL calls the 
following routines: 


e Diagnostic message directory print routine CHEWLFBTP), which 
scans the error logging map produced throughout linkage 
editor processing by the error logging routine 
CHEWLFLOG—Chart GC); HEWLFBTP builds and prints a directory 
of error messages. 


e MAP/XREF processor CHEWLFMAP—Chart EB), which produces a 
cross-reference table if it was not produced during 
intermediate processing. 


Exits: If end-of-file was not detected on a SYSLIN input, 
HEWLFFNL returns control to the initial processor CHEWLFINT);, 
and linkage editor processing is repeated. Otherwise, linkage 
editor processing is terminated, and control is returned to the 
control program. 


SYNAD Routine~"HEWLCRO1 (Chart GB) 


Entrance: The SYNAD routine may be entered from the following 
routines: 


e From the control program when any input/output error has 
been detected 


® From the second pass processor if an error is found after 
executing the XDAP macro instruction 


Operation: Following are SYNAD considerations for the linkage 
editor: 


e The SYNAD fields of the DCBs in HEWLFROU contain the address 
of the appropriate SYNAD entry point for the access method 
used with the data set. 


@ If the SYNAD routine is entered from the input processor 
because of incorrect length, the length of the incorrect 
input block is checked. If a valid short block (integral 
multiple of (LRECL) is found, control is returned to the 
supervisor to continue processing; if not, processing is 
terminated with an error message and completion code of 16. 


e If the SYNAD routine is entered while writing to the 
SYSPRINT data set, control is passed to the final processor, 
and execution 15 abnormally terminated with a condition code 
of 16. 


® When the include processor opens the DCB for SYSLIB, the 
address of the appropriate SYNAD entry (for either BSAM or 
BPAM access methods is moved into the SYNAD field. 


e If the second pass processor finds an error after executing 
the XDAP macro instruction, it loads register 1 with the IOB 
address, loads register 15 with the SYNAD entry point for 
the EXCP macro instruction, and branches on register 15. 
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oe ROCESS oe 
oe ee 
oe oe 


ON- PASE 
CONNECTOR 


OFF - PAGE 
CONNECTOR 


| coos 

->¢02 6 
* Al ¢ 
e e 
eevee 


CooseK] Ceoeeeevece 
@ ~~ - = AAXKAKX- --- 6 


° MINOR ° 
© SUBRVUTINE e 
: BLOC K ; 


THE TERMINAL BLOCK =e USED 


SOOO A OSC OCOOOS TO SHOW ENTRY AND 

° ° POINTS OF A ROUTIN E 

° HOURSRTN ° BLOCK B3 SHOWS AN ENTRY 
° ® POINT NAMED HOURSRTN. 


GETT 
CeoeeBjesoovsoccces 
e e THE INSTRUCTION AT GETT 
o---- caataataatiied CALLS A SUBROUTINE NAMED 
© FIND MTABLE ° SUBNAME THAT IS FULLY 
e ENTR e DEFINED BY THE TEXT IN THE 
® ° TEXT BLOCK ITSELF, 


sees 
® e 
¢¢c3°¢ 
® e.> 
oeoee 


COCSSC JOCoooeS+ECS 


ooee | 
e e 1 
eps ¢e ON-~PAGE ENTRY CONNECTOR. 
e e-> ONE OR MORE BRANCHES TO 
eooe THIS BLOCK APPEAR ON THIS 


PAGE OF THE FLOWCHART. 
CoveeHjyeoreereces 


e e 
e e 
e e 
e td 
e e 
SCOoSeoeeseseseess 
e000 
eoi1 ° 
e Es e-> OFF-PASE ENTKY CONNECTOR. 
® e A BRANCH TO THIS BLOCK 
eee APPEARS ON ANOTHER PAGE(S) 
.f, OF THIS FLOWCHART. 
E3° “6, 
Aad s, 
.e e 
Soo8, o-_- 
®, a) 
e, a) 
ee. .e 
e 
GOTO YYAl 
SOCcerjeeccce secs THE INSTRUCTION AT LOCATION GOTO 
*SUBNM ° CALLS A SUBROUTINE NAMED SUBNM 
0-6-0 0_0_0-¢_e8 THE Locic OF SUBNM [2 SHOUN ON 
° ° CHART YY STARTING AT BLOCK Al. 
e e 
Seeoeoeeoeeseeoeoeose ees 
, 
LINE JUNCTION 
L .e, 
I G3 “e, 
eceeGrececccere N .e °, ON- PAGE EXIT CONNECTOR. _CONTROL 
° ° E .° °, BRANCHES TO BLOCK D3 ON THIS PAGE 
° RETURN Sceeea | eet ee, i ero7y OF THE FLOWCHART. 
ececoesoeeeeeeeoees R e. e ! 
oO e, ,®¢ eoee 
Ss e e 
Ss * pie 
I e 
ME... > eoee 
G 
sccoeHzeccococcce THIS BLOCK REFERS TO A ROUTINE 
ee OR PROGRAW THAT IS DOCUMENTED 
o8 «EXECUTE ee IN SOME OTHER PUBLICATION. 
ee | -UTLXYZ ee 
ee ee 
ee ee 
*eCesesseeeseseeese 
e, 
yyce, 
eoeejsreccccoces .¢ °. OFF-PAGE EXIT CONNECTOR. CONTROL 
e ° .° °. BRANCHES TO BLOCK Al ON PAGE 2 
® RETURN e<--- a o. go trrcp (OF THIS FLOWCHART. 
® e . 
SCeoececessceoeeeete e, @ ’ ! 
e, .¢é eocee 
CONTROL 1S RETURNED TO ° e02 ¢ 
A VARIABLE POINT. (FOR e Ale 
EXAMPLE THE POINT oe 
AT WHICH THIS ROUTINE ° 


@AS INVOKED. } 


CooeKjoeeoosecoe 


e 
: GO TO TAXRTN ; 


CONTROL BRANCHES TO AN ENTRY 
POINT ON ANOTHER FLOWCHAAT. 


Figure 32. Sample Flowchart Symbols 
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CHART _A EVE AJOR DIVISIONS 


SSH AUSE SEES SEES 
eeeeAececesese * HEWLF ROU e 
¢ * _¢_¢_6_¢_¢_¢_6_¢ 
*CONTROL PROGRAMS&-------- > 6 
* * : ENTRY POINT : 


SECTS ESSE SEES 


SCOCCHEEHEEHHEES 


$6666H 3666666088 


*HEWLFINT BAA3® 
¢_¢_¢_¢_6_¢_¢_¢_6 


* INITIAL ° 
¢ PROCESSOR ; 


e 
CCoSe eR ET EEE EC EEE 
INITIAL PROCESSING | x 


SOSSECISCSCSSEEOEED 


* HEWLF INP CAA2* 
6_¢_¢_¢_6_6_¢_8_6 
e 


e 
da PROCESSOR* 


SOSH EESESHTEOEEE 
INPUT PROCESSING 1 x 


SeeseHjseoseceeses 


*HEWLFADA DAA1* 
o__b_0_e_e_9_¢_¢ 


* ADDRESS * 
* ASSIGNMENT - 


* PROCESSOR bd 
oeeesseesesecoess 


SOCCER TOC CCHE CHEE 


*HEWLFOUT  EAA2* 
+¢_¢_¢_¢_¢_¢_¢_t_¢ 


* INTERMEDIATE * 
* OUTPUT bd 
bd PROCESSOR * 
CoC S SOS SE SSO EES 
INTERMEDIATE PROCESSING | x 


we ewe mm me ew wm em ew wn @ we mw ew tw we wm oe we ew ew em ew 2 ow ew em we me ee eB eww ew we 2 ww ow mw aw a aw a a we a ee wm oe ee a we oe we eee ee 


OCCOCOC EF] OaSSeseseese 


*HEWLFSCD FAA2® 
o_¢_¢_¢_¢_¢_@_6_6 


* SECOND PASS *& 
. PROCESSOR : 
Soe CC Oo ESSE EEO OES 
SECOND PASS PROCESSING | x 


ene em ewww oe ww we ee we ee ew mw a we we we ee ee en oo = a ww a a a wr a a a a a wr a we ew ew ww = ww oe ew ww nw ewe ew ew ee a we ee eww ow ew eee ee we ew ew ee ee 


° e 
Peal PROCESSOR® 


CHOCO OH OEE RHE EES 
FINAL PROCESSING I x 


Coos Ss eeeeeee 
. 


* 
*CONTROL PROGRAM® 
° 

Coe eeeeeeeesees 
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CHART BA, INITIAL PROCESSOR (HEWLFINT) 


PROM FINAL PROCESSOR 


000G1eseeeeeos 


HEWLFNAM 


PPP E RL ERT E SES 


SoseeH2essevesss 
*PLACE STANDARD 
*DONAMES IN DCBS 
* OF ALL DATA 

° SETS 


bd NO 
#¢€-------- *, LIST PASSED .* 
* e, Pid 
e e, .° 
e es. ,8 
° 
sCectscc cece occa c owe ook ne ee 


.*, 
G2 s, 

ad *, 
.¢ SYSLMOD °*, 
20s DRTh SET OPEN. 

eo, ss 
*, 6 
*NO 


ooH2eeee008 
° 


6 6 
a AOE ER SYSLMOD 


FROM ROOT SEGMENT (HEWLFROU) 


¢----> 
e 


COOOA OOOO SOOES 
6 * 
° HEWLFINT * 
r r 


SeseeBieesevescese 
*SAVE REGISTERS °*° 
*3-12 AND PLACE * 
*ADDRESS OF APT ° 
. IN REGISTER 2 ; 

° 


SOSo ECT OOO OOOO HES 


*HEWLFOPT 
60-60-69 8_ 6 


° 
° 
*ATTRIBUTES AND * 
° OPTIONS : 
° 


PT 
. PROCESSOR 
Sooo e SERS OO SHOES 


2%, 
D3 °. 


find *, 
»® PARAMETER *. YES 


seeeeEeeseeseeee 
e e 
* SAVE DDNAMES *¢ 
*FOR SYSUT1 AND * 
‘ SYSLMOD . 
sesetooeoeseeoeetos 


Corjecsoces 

e e 
* OPEN SYSLIN * 
* SYSPRINT * 
*, SYSLMOD | 


% 

¢ ESTABLISH * 

¢ MULTIPLICITY § 
s 
° 


* 
SOOSCHCHOTSHOOEHS 


ALLOO1 


SeoeeG eseesesoes 
e ALLUCATE ° 
* INPUT/OUTPUT, * 
* LOAD MODULE, * 
*  RLD, TXT * 
r UFFERS e 
Ceesetesoeeeoeeseee 
ooeee Gaseoeveege 
¢ HEWLFALK ee ° 
e o 
¢EatttaL/e 


ALLO43 


COOSST ECF oCeeres 
*CLEAR REQUIRED * 


bd PARTS OF ° 
* PROCESSING bd 
% TABLES : 


Sese Ki esesecese 
° ° 
* HEWLFINP bd 
* ° 


TO INPUT PROCESSOR 


SoSTEDUSH OS SEE EER 
* PLACE PASSED ¢* 


aes iy 3 IN DCBS*® 


OF ALL DATA ¢ 
. SETS : 
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CHART BB. TABLE ALLOCATION PROCESSOR (HEWLFALK ) 


See A2eeeeteee% 
¢ 


* 
. HEWLFALK : 
Sod EREEEDERE DES 


Vv 
-*. at 
B2 *, B3 +, 
.* *. .* Is *, 

-* IS OVERLAY “:,NO 4: * HIERARCHY *', 
*, SPECIFIED ." AR eevee or, “«, SPECIFIED. *° 
*, «* *, * 

*. cree td 
* s 

|YES YES 
Vv Vv 
eeeeeC Jes eeeesees eeeseCieessentece 
* -TNDICATE “OVERS —.. 29% o “PEE SULICN 7) 2 
. * * INDICATE HIER- 
e LAY TABLE TO *© *#p26 * * 
* BE ALLOCATED * ¢& oe eROny TO: PF bd 
* . eee ¢ ALLOCATED * 
SHH HHEKO HEHE ] PELE Eee eee, 
ees tact ete Sy | 
: 
D2‘Is «. TrTTPKTLTT Ter Tee 
-*THISA *. ‘ 
-* REQUEST *. YES + CALCULATE . 
*, FOR RE- « $------~- >* AVAILABLE * 
* ALLOCATION * % BYTES/WEIGHT $ 
“el ie Pe eeeeeeeereeaeee 
#No 
V 
eseseE2eceeseeege 
*. * 
* * 
* BYTES/WEIGHT=9 « 
. o 
* e 
SOSH CEHECEH EEE 
eo ees Ny Sa ce ech tote ed eae 4 
Vv 
eveeerzesteeneene 
% CALCULATE 
« TABLE SIZES: »« 
$ MINIMUM + : 
a (BYTES/WEIGHT) , 
e WEIGHT ms 
aan weal 
seseeGlensecseeee 
* UPDATE APT IN- « 
. FORMATION ON * 
» TABLE SIZES ‘ 
e AND LOCATIONS) ¢ 
PCCESCHCHO HEHEHE HEHEHE 
Vv 
Oe 
* * 
*RECORD HIGHEST * 
‘ADDRESSES USED ! 
«BY TABLES IN ' 
*FIRST PASS u 
¢ INTERPASS, & e 
* SECOND PASS) ¢ 
dae rh eeeen 
V 
ets 
J2 Ise, eoece tJ eeeeeeeene 
-*THIS A *, ¢ NOTE THE HIGH- * 
a fe VEST 2 NO? =>. EST ADDRESS . 
¥. f * IAL ALLOCATION * 
*. * Ceres eetesereegee 
YES 


TBAL 300y 


SHH KZ Cee ee eens 
*MOVE AND CLEAR * 


FEC CK Jove eeerene 
* SET SWITCH IN * 


STABLES AFTER § | >2 APT TO SHOW $ 
* REALLOCATION + + RE ALLOCATION « 
* * * HAS BEEN DONE * 


SSS HHHEHEHHH HEED OCC HEEHEC HEHEHE 


$s 
NO * * 
-—-—--- >*D2 * 
° 
tee 
seeeeTdaceseenesene 
* SET SWITCH IN” *¢ 
aces $ APT TO SHOW IN- $ 


« ITIAL ALLOCATION, 


PPOSTHOHFCH SETHE SHE HEE 


HAS BEEN DONE . 


SCH K eee ereete 
* 
RETURN i 
COC HHELOO HOE 
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CHART CA. INPUT PROCESSOR CHEWLFINP ) 


6 
INP12 -* 
c2 


PROM INITIAL 
PROCESSOR 


COCOA 2O00CCEOEE 
° 

HEWLF INP : 
HOSCCOOEEEOHOES 


eop2erecete 
e 6 
° 


* READ A RECORD 


e ¢ 
SHC66OOOHCSEE 


e 
Cd 
e 


B3 *, 


>*, TAKEN -¢ 
e * 


FROM OPEN DURING 
CONCATENAT ION 


OSSD Seeesenees 
* 


* 
* DCB EXIT * 
* * 


Sseeesetesseeeesd 


Seese Hh eeeesesees 
* HEWLEXIT * 
e_¢_ 6. 6. 6. ¢_ 6 6_6 
*OPEN EXIT, SET * 
* INDICATOR AND * 


* RETURN sd 
eessererseeseoeee 


1972,1983 


*, ShOSEC TESereseeee 
OOSCCLOSeEseses .° 6, *INP270 cCcA1¢ sees Seceessese 
° EOF ON SYSLIN ° .° IS THIS A'*. YES o_¢_0_¢_¢_0_0_0_¢ . * 
. DCB ° 2 LOAD MODULE ;*¢------- >* LOAD MODULE *--- . RETURN ‘ 
Ad * e e bd PROCESSOR e e 
Sheoeseseseeseseese ¢, * ¢ e COOSSHECHEHEHESEEE 
¢, .¢ SOSeeeeeeereseeeseres 
*NO * * TO OPEN 
¢ B26 
e e 
eee6 
HEWLFEON INP13 .*. 
eeeseDlesccscosce D2 *, eeeeeHjeccesececs 
° e .¢ *, *¢HEWLFMDI  CBAI® 
® SET AUTOMATIC © .*” CONTROL “*. NO o- 6.6 0-4 0-6 0-8 
* LIBRARY CALL ¢ *: STATEMENT .#-------- >* OBJECT MODULE ¢--- 
*¢ INDICATOR ON *¢ *. ° ¢ PROCESSOR | 
Steesesseoseseose “el ie Seeeeeeseseoseseseses 
*eYES e * 
¢ B2 *¢ 
e e 
eee6 


OOCOCE] COetesesee COCO E PEC ec Eseeee 
e 


bd * HEWLFSCN CSA1¢ 
* SET END OF * 6066 _6_e_8_t_e 
*INPUT INDICATORS s CONTROL ‘ 
e ON ° * STATEMENT ® 
e * * SCANNER bd 


SOSSC SE SCHECSEHEEOE SOCSHHEEHSCHHSHEEEES 


 & e*. 
Fil *, F2 *, 
* 6, ~ e, 
o# INPUT *,. YES ~@ NAME *¢, NO 
oat RECEIVED . ¢----- we STATEMENT Pies 
e, .* s, e* | 
e, .% ¢ ,® eeee 
*NO *YES * ¢ 
¢* p2e 
e e 
e086 
TO 
PINAL GAG2 
PROCESSOR COCSHG2 OS CHEEEEEE 
$O66G1 Sbeeeeees e * 
° ° * SET AUTOMATIC *¢ 
s HEWLFFNL s ® LIBRARY CALL *¢ 
bd * ¢ INDICATOR ON ¢ 
SOSH HSKEEOESESE e 6 
seeseeooeeseseses 
HEWLFEOD .*. 
H2 6, SesesHjeseooesece 
Sooo seceseses e e, * HEWLFINC CVA3® 
* EOF ON SYSLIB * -* ANY MORE ¢. YES .6¢_¢_¢.6¢_6.0_t6_¢% 
* DCB One nwee-- >¢, INCLUDES » @------ oe >* INCLUDE e--- 
e ¢ *. Aid * PROCESSOR ¢ 
esoestoeseoseses FROM LOADS., .* s e 
MODULE ¢, 6 SCECHEEHHEEEEEEHEEEEEE 
PROCESSOR *NO . e 
* B2? * 
* o 
eees 
~*, »*, 
J2 s, J3 s, 
-* IS ¢, fe *, SHOE TECH OO OEEES 
e* AUTOMATIC *. YES Pid *, YES ¢ TO ADDRESS bd 
*. LIBRARY CALL . *-------- >¢, NO CALL » @-------- >* ASSIGNMENT bd 
*, INDICATOR. * s, .* * * 
e, SET .¢* e, .¢ Seeseoesseesere 
*. * *, * 
*NO *NO 
\ ete 
=>e e 
°* p2e 
e e 
eee 


eeeeeK Jeeseseeeese 
*HEWLCAUT CWAZ2¢ 
e_¢_e_e_e_t¢_@e¢_t¢_e 
* AUTOMATIC *¢ 
* LIBRARY CALL * 
¢ "PROCESSOR * 
SHCCE OSE SSESCSeERSEEE 


oeage 
->*¢ e 


* B2 * 
ry * 
eens 
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CHART CB. OBJECT MODULE PROCESSOR (HEWLFMDI ) 





FROM INPUT 
PROCESSOR 
eeoee AL eeeeennes 
‘ e 
‘ HEWLFFMDi eos ote 
* 
Coes beseteseses 
«*, 
cil *, 
.* s, 
* e, 
---*, RLD RECORD. #<----- 
Pipi 2 
*, .* 
ha 
INP130 Vv 
C8EHEHOL OSES eH EEEs 


‘ * 
* CLEAR TEXT * 
bd INDICATOR * 
* * 
* * 
* * 


LES ERE L EEE EEE S| 


SCOKSHE] CHSC HHHHHS 


*HEWLFRAT CFG3* 
$4_ ¢_6_t_6_¢_t_@ 
* RLD AND TXT 
* PROCESSOR * 
* * 
CHHH SETH ETE TEED ES 


ccG3 


SOOO PL OSHS SSSE8 
* 


* 

* INP270 * 
* * 
ORS EHHEOODEEDE 


Gl *#, 
.* +. 


SOSH AHL OES HOE DSHS 


* HEWLFLOG GCA2* 
o_¢_¢_0_0_@_¢_@_e 


*UNRECOGNIZABLE * 
* INPUT-NOT * 


* OBJECT MODULE * 
PHHEOHEHERERED OED 


ccG3 
Coea TL eeseesene 
Py * 
* INP270 * 
* * 


TERE REE ESE E RS SO 


Sey INP22 
INP40 A2 e. SOSH RA OCH OS HE EHS 
« *CONTROL®*. * HEWLFLOG GCA2* 

-* STATEMENT ¢. NO *_6_6_6_e_e_e_e_e 
-~>*, CONTINUATION ,.*-------- >* CONTINUATION *--~---~ 
*, 7 *EXPCTD BUT NOT * 

*, = * RECEI VED . 
. ,¢ SHHSHESEC OSES E OES 
*YES 


1 
SeHOPA2 OCH HHH HE ES 


*LOAD PARAMETER * 
* REGISTERS AND * 


* SET ON MODULE *------ 


* INDICATOR IN * 
* APT * 
SHSSCHSHH HR EHHHKEHEE 


INP1 60 ive, 
“a fo em 
.* WERE SYM *, 


*. RECORDS « @------ 


*, RECEIVED .* 
*, _¢ 
*. J 

*NO 


SHCOHE Oboe ee eEHS 


Ls * 
* SET TEXT * 
---4# INDICATOR Mes Sia 
e 
* * 


SHCSHHHEH SHEE HEHE 


aM 
F2 *. 
~*IS SYM *, 
e* RECEIVED *. NO 
-~>*. INDICATOR ON 


*, .* 


*, C8 
*YES 


SCHHHHCZ FS EEES SHEE 


*HEWLFSYM CDA2* 
¢_0_¢_¢_@_¢_¢@.6_¢ 
e * 


* SYM PURGE * 
* * 


SOHSKHTHHEH HORE HE 


«*% *, 
.* DOES END *,. NO 
*.CARD CONTAIN .*----> 
*. IDR DATA? « * 
*. .* 
% o 


*YES 


OSHS T2ZECHS EH HEHE 


* * 
*TURN ON *OBJECT® 
- IDR’ SWITCH bs 
* * 


SCSHHSHPSESEHEDEEE 


INP 340 
OTHE K2 OF SHEER EE 
*HEWLFIDR CMA2 * 


Co ee ee ee ee ee ee ee 

* PROCESS IDR *#----- 
* DATA : 

i 

TRE PERSE RSEREE EER) 


NO .¢ “e, 


SeeeeHj eeseteesees 


*HEWLFSYM CDA2* 
$__@_@_#_¢_t_e_@ 
--->* * 


* SYM PURGE * 
e ¢ 


SCHHSHEHHSEHHHHHERESE 


COSHH EZ OCHS OH SEHD 


* 
bd CLEAR SYM 
* INDICATOR 


* 


* 
* 
b 
* 
td 
LER SESE ESE EEE ELE S| 


INP70 -*, 
F3 +. 


-* *, 
«*ENTRY POINT*. YES 


ET ESD 
area det INDICATOR ON 


ccG3 


SHSHAL HSH SH HESS 

* * 

INP270 * 

* 

oteseeresseeses 
A 


NO 

INP150 -*. 
B4 *. 

* * 


* TES “e. YES 


a T 
~--9*. INDICATOR ON . #-------- 


* 


INP140 
SHHSHECHSSH SSE SHEE 


e 
* s 


* 
* 
* 
i 
* 
RSE CEES ELE ESE S SE 


See eeHUSeeesegees 


*HEWLFESD CEG3* 
¢_¢_6_¢_@_¢_¢_¢_6 
* e~--.-~-.. 


* ESD PROCESSOR *¢ 
* * 


SHSHELEEEHHEHEHEES 


INP9O 
CHHHEP USEC HE ETES 
* LOAD GR4 WITH * 
*CONTROL SECTION®*® 


-->*, INDICATOR ON . *----~---- >*LENGTH FROM END#*-------- 
. . * RECORD * 
*, _* * * 
*, .* eoeeetesetesenerse 
*NO A 
e090 
* + 
* * SS 
* * 
eee NO 
*, INPSO ae 
G3 *, Gu e, 


.* * 
-* ABSOLUTE *. NO 


*. ENTRY PGINT |. * moeee 


*, .* 


*, 
*YES 


Poe aeHJoaeeseeess 

SET ABSOLUTE 

ENTRY POINT 

INDICATOR IN 
APT 


* 
* 
* 
* 
* 


LEER REE ERE ESE EES 


OSCE TICS HOO RSHES 
* 


* 
*STORE ASSEMBLED*® 
ADDRESS IN APT : 


* s 
SHHSSHES HSH HES SHES 


| aeons 
> * 


* G4 
* * 
eens 
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‘~-->*, 


o* *. 
-* SYMBOLIC *, 
ENTRY POINT .* 
* 


* * 


*, ,¢ 
*YES 





SHHHHH HY SH SOSH EDDS 

SET SYMBOLIC 

ENTRY POINT 

INDICATOR IN 
APT 


eotenwee 
etetete 


SHCHHCHDRHHHDBOKE DE 


Steet TUL Sess seees 
* * 
*SET ENTRY POINT* 
* INDICATOR IN * 
* APT * 
* * 
Seeessesceseveees 


SHHHHKYSS SOSH OHSS 
* * 
*STORE SYMBOL IN® 
* APT * 
* * 


* * 
SOSHEHEEH EEE HH DDE 


Corp. 


COR RED SO OHH TEESE 
* * 
* LOAD GENERAL * 
>*REGISTER 4 WITH* 
: BYTE COUNT : 


(REE E SEER EES EELS SE 


St erec Steeseenege 


*HEWLFSYM CDA2¢ 
+. *_6_¢_6_¢_9_¢_8 
* 


* 
TOBNE SYM RECORD® 


CREPE ERS ESEESERE SR 


ccG3 
OH EH HSH SE HEE 
* * 
> INP270 * 
* 


SCHOSHHEHETHHEESE HED 


*, 
FS’ "*, 
~* *, 
* GRY *, NO 
>*) CONTAINS .#--- 
*. (LENGTH |. ¢ 
a 
*YES 


Coe eEC eee ee eEtes 
* SET NO _ LENGTH ¢ 


. RECEIVED * 
* INDICATOR IN ¢# 
+ APT * 
* * 


PRP EERE EES EE SEE SE 


SHOE H Hee SSH SEES 


*HEWLFEND CLA1* 
o_¢_¢_e_6_¢_¢_#_6 
* * 


2 END PROCESSOR : 


PERE REC ESE SES EE 


SOHEE THER HDE DODD 
* HEWLFRAT CFB3* 
o—¢_¢_¢_¢_6_8_9_¢ 
* * 
SEND CARD PURGE % 


CECH HEEEHEEHEES 


CcCG3 


SHORKH OOOH EO ODS 
* 

INP270 2 
HEHE HERE EEE EEE 


aoee 
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CHART CC. LOAD MODULE PROCESSOR (INP270) 


FROM INPUT 
PROCESSOR 


SSSA seoesoces 
* 
INP 270 


es 
s s 
s td 

SHS SEHCSCHOOC HOSED 


INP270 .*, 
.* "eo, 
‘. e YES 
*. SYM RECORD ,%------ 
Pig. a 
e*, .¢ 
*NO 
INP281 of 
* “e. 
* a YES 
*, ESD RECORD , &------ 
"eo, Pre 
*, ,¢ 
*NO 
INP290 .¢, 
e *, 
Pid 6, YES 
*, RLD RECORD. %------ 
“e, oe 
e «* 
*NO 
*, 
INP300 El *, 
-*° CCW/RLD “*. YES 
*. RECORD » eee 
ve, o 
*, .¢ 
*NO 
INP305 fe 
id "eo, 
. *. YES 
*, RLD RECORD, *--- 
.. Pe i 
e eee8 
*NO * . 
* FI 6 
6 e 
eee 
INP320 -*. 
-* "e, 
-* SCATTER *. YES 
s, RECORD . 
“eo. ss 
*. .* 
*NO 
INP330 o*, 
*, 
Ps e 
-* ‘, NO 
*. IDR Stace =s 
eo, oe 
e*, .¢ 
*YES 


SOCSS TL SOSH EC CEHS 


* * 
* TURN _ON "LOAD * 
sop IDR SWITCH® 


4 
OOOCOKL COCO CE OEEE 


§ HEWLFLOG CMAZ* 

—~¢_8_6_6_e_6_6_s 
: PROCESS IDR ¢ 
: DATA : 


SOSH SCHKSSHHEHHHHHSD 
| eee 

->¢ * 

* K5 6 

e * 


be SET ESD 
ae INDICATOR ON 

+ . 
COFFERS EHEEEH EES 


sees enze ss cee sees 
LOAD STARTING § 
* ADDRESS OF RLD 
INFORMATION 
« INTO GENERAL 
+ REGISTER 6 
SHOES SE DESEO EEES 


SESSHE2 CFO OO OSES 
* LOAD ASSIGNED 
* ADDRESS OF 
FOLLOWING TXT 
* INTO GENERAL 


® REGISTER 3 
COCHEEEC HOD EOEOES 


eee 

e td 

°* H2 6 

e ee 

eoes6 i 

INP282 

SSeS eHDeeceseseses 
SHEWLFEND | CLAL$ 


$66 _ 648.6 _t 


° 
. END PROCESSOR : 
COoCe SOHO RESO OEES 


~* ¢. 
Poe eae RECORD |. * 


COSCO KIOOCHHHHHEHE 


¢ HEWLF SYM : GCAZ® 


: UNRECONI 2ABLE . 
*INPUT-NOT LOAD ¢ 
bd MODULE * 
SCOCSE EEO SERETESES 


| ooee 
->¢ . 
* G3 ¢ 


> 


INP310 £3" *"s 


YES 


oe68 
* 


* H2 
* 
coos 


INP 


SCO6SCSHHISCSSCeHSeSes 


¢ HEWLPSYM | CDA2® 
e.6_0_ 0. 6.00.6. * 
. . 
. SYM PURGE * 
e * 


COSHH EEHESHHSD 


| eeee 

->* . 
® G36 
* * 

eeee 


$OOF6CIOOS FOES EEE 
*LOAD NUMBER OF ¢ 


REGISTER 4 
SHOHESHEES OOOO EES 


SHHOEH IOS OR ESEEEE 
*LOAD NUMBER OF * 


* BYTES OF RLD * 
® INFORMATION * 
* INTO GENERAL * 
* REGISTER 4& * 


SHSSHHHHHSHHHEOED 


SOSHHE OSC OR OFEES 
*LOAD BYTE COUNT® 


* OF TXT INTO ¢*® 
* GENERAL ° 
: REGISTER 4 : 
SOOCESHEEDEOE FEES 
sees 

. Py 

* FR 6 

e e-- 

eeee ¥ 


s 


e 
« LAST RECORD 
e, 6 
¢, 


x 
. ¢ 


r 
oeees 

* ° 

*Gie 

ry > 
ooee 
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G3) *s, 

.¢ *. 

.¢ IS RETURN *, 
FROM £SD 


Chee Heese eeee 


HEWFMINP 
SCHOHC HEROS EOSEOE 


INP111 


SOSFSTIVEVC ESOS O EES 


* 6 
*SET SYM RECEIVE* 
* BIT e< 


6 
td 
SOOO HHOHHHEHOHSER 


OOCCCK OCC CHOC OEE 
*HEWL SYM CDA2Z® 
o_4_¢_¢_¢_¢_6_¢_ 

. : 
; SAVE ESD CARD ; 


SCOSCHCHHHCHOHHHHHSES 


| eens 

_>e e 
* KS ¢@ 
e e 

eee0 


Paes Sebald sbohe 
*LOAD E ID OF ¢ 
sist ENTRY INTO be 


G 
: REGISTER 5 
SOS SR OCHO ESOS EES 


S$OSOHHNU SHEE O HEHE 


* HE RAT CFB3* 
$_e_8_0_0_0_6_0_6 


>* PROCESS RLD *¢ 
* INFORMATION 2 


* 
OF F6OSHHHSEHHHHD 


SOHO E HAH COHHESES 


* 

* LOAD ID INTO 
GENERAL 

REGISTER 5 


* 
LEC ESET ETE ET EET SE 


* 


eeeveon 


ei loceiesees ose Sees et Sess Sele et 
a @. 
Gu %, 
-*IS ESD *, 
YES WRITE 
Seeeowes >. INDICATOR on’ agtee 
“e. | 
s, e eees 
oe ¢ td] 
* K5 6 
6 e 
eo68 
*, 
HY : 
¢ . 
.*° IS TEST "*, NO 
¢. INDICATOR ee 
sys : J 
. 8 ooee 
*YES e * 
* KS ¢ 
* * 
| eoee 
‘ge 
NO YES 


ih INPUT wr 
ene SER LOAD MODULE ; ¢--~----- 


ORS SCSeeeeereees 
S LOAD ADDRESS OFs 


ESD 

INFORMATION * 
* INTO GENERAL *¢ 
* REGISTER 6 . 
$608 66 SES EROC HOOD 


SOS EENSSSeeeeeees 


¢HEWLFESD | CEA1$ 
—O_ 6.666 _6_8_ 
° PROCESS ESD * 
¢ INFORMATION ¢ 
SCOSSHHTEHCHHEHHOREOD 
| eeo0 
->* * 
* G36 
* * 
ose8 
eoo08 AY ceaas 
* HEW CFB3¢ 


>* PROCESS TEXT : 
: INFORMATION : 


SCOSSOSHSSEESCE SHO OD 


Coors 5 ovevessees 
¢ HEWLFSYM | CDAZe 


SYM PURGE ° 
Sebbeueeeeedeuses 
oes 
K5 


eee 


* 
o 
*-> 
* 


OOO K5O00008bb8 
e * 
: RETURN : 

OOOOH EEEOE 


TO INPUT 
PROCESSOR 
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FROM LOAD OR 
Se 
SOCCAIOCOOOOEEE 
: HEWLFSYM ° 
aeeeieackeuswee. 


SYM00100 .*%. 
B2 *, 
.* *, 
NO .¢ *, 
eee ee mre eee *- OBJECT MODULE. ¢ 
e, _* 


eo Pad 
eYES 
SY¥M00200_.*. SYM00900 

SOOCOC1L OOOOH CEES c2 Lo COCSECIOCCOOHOOHOES 
° . .¢ 6, * 

*INITIALIZE FOR ¢ .* I5 RLD |*, NO * MOVE e 
*WRITE FROM RLD *: BUFFER TO BE . ¢-------- >* RECORD TO RLD ¢ 
e BUFFER ° *. PURGED |.° ‘ BUFF 


“eo. « 
*YES 


eeeeeH2eceeseesee SeeeeeHjpeceseeseee 

e e 
*INITIALIZE FOR * 
*WRITE FROM OBJ * 
¢ MODULE BUFFER * ‘ ‘ 
SOSH HH SESE EEHE SOSSHSCHSHHHEHCEEES 


e e 
S INCREMENT counT® 


SYMO00300 
COOL 2 eeeeeeoeete 


e td 
gTRITE AND CHECe 


F2e¢eeeee00 

e 
RETURN e 
COOKE HOHE EEE 


SYM00500 
etee 

$ 

° 

e 
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CHART CE. 


FROM INPUT 
PROCESSOR 


PITT TSE Liitiriy, 
r . 
: HEWLFESD : 


Seeseeeesessesed 


SOSSOR1L CHOSeeee44 
*INITIALIZE SAVE* 
* ESDID, NO. OF ¢ 
*ESD ITEMS, ESD © 
¢ TYPE, ADbR OF « 
* CESD * 
SOC OCCC8CCHESHEE 
9998 
2 s 
*cl1 se 
s s_> 
eoee 


ESD1A0 *. 
cl bd 


.*1S ESD *. 
*TYPE PSEUDO*. NO 


*. REGISTER (PR), ¢---- 


ESD2 *. 
o1 *. 
.* ANY °*, 
-* REPLACE’ &, 


*, CHANGE t==-5 


*, SYMBOLS .* 
* * 


ESD3 


2¢ *, 
-*IS ESD TYPE*. YES 
*. PRIVATE CODE .* 
e, (Pc) .* 


e, .* 
*, .* 
*NO 
e .. 
Fl *, 
.* *. 
-*IS ESD TYPE*. YES 
*, N »#---- 
, e 
e. .° 
., .% 
*NO 
aM 
G1 *, 


-*IS ESD *. 
-*TYPE LABEL *. 
*. DEFINITION .* 

*, (LD) -¢ 


eee8 

*01 © 

* H1 *-> 
e e 


ESD4 Vv 
CoeetHl eeeesssege 


* e 
*SEARCH THE CESD*® 
*FOR A MATCHING * 


* SYMBOL s 
° ° 


eters 
01 ¢ 
# Jil t-> 
* * 
oes Vv 
ESDS .*. 
Jil 


-* ¢. 
-*IS THIS THE*. NO 


*. END OF THE .*®---- 
° ESD 


e c * 

e, .* 

.* 

*YES 

| eees 

->002 @ 
* Al * 
* ° 

eee 


NON- RESOLUTION 


PROCESSING 


see l5e, 


Coote RJeccecesess 

s 

SET SEGMENT * 
NUMBER TO ONE : o+--- 


bd 
SHSSHHHHHHESHSHEE 
A 


YES 
eoeseC2esessesees C3. Oe, 
*INSERT CURRENT * -* TS s. 
*SEGMENT NUMBER * -* AUTOMATIC *. NO 
---->8IN ESD (IN BYTE*-------- >*. LIBRARY CALL . ¢------ 
bd 12) sg *, INDICATOR. ® 
e % e, ON Pd 


SOO egeeseeseeses *, .® 


SeeoaNH2eseseeeees 
* HEWLFRCG * 
o-¢_0_¢_9_0_¢_8_8 
° SCAN * 
*REPLACE/CHANGE * 
° CHAIN * 
COCHHEHSEH OEE OEES 


ESD20 
oeceeE2osescrsecs 
*¢NXTLINE * 
o_6_0_0_e_0_9_0_8 
---->*SET POINTER TO *--- 
*¢ NEXT LINE OF ¢ 
* CESD e 
COSHH O HEHEHE EEEEE 
©02 * 
oeere * C2e 
0304¢ e-¢ 
* FZ ¢_- * 
e e 
cece 
ESD29 ~*%, 
CoseeP2eseeserrrs F3 *. 
* RENUMBER * .* *, 
$_¢_0_6_e_0_0_0_8 -* IS COMMON *, YES 
---->*TRANSLATE ESDID®*-------- >*, INDICATOR ON .*------ 
* TO CESDID IN * *, Pid 
*®RENUMBERING TBL® *, ied 
rrrisirir rer irs fy *, 6 
*NO 
oeee 
e01 
# G3 %-> 
* ° 
otee 
ES030 *, 
ooeeeC2eeeeseeces G3 e. 
*CHANGE TYPE TO * .* * 
® LR, INDICATE ¢ »* ANY MORE °*. YES 
---->eTHAt IT WAS AN ® *, INPUT ESD , ¢------ 
* LD : *, ITEMS .* 
PETTY TTITITTT ITT) ee ae 
*NO 
PERCH 99 FC EE EF 
Py Py 
* RETURN 2 


-¢ *. 
»* DOES ESD *. 
MATCH CESD .* 
*, SYMBOL .* 
‘ .* 


e, .* 
*YES 
eee 
->*02 8 
* AW 
* * 
ooee 
RESOLUTION 
PROCESSING 
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ESDIA .*, 
cy“ e 


Pid “eo, 
-°IS ESD TYPE®. YES 
red ER OR WX Po 


ESD43 
eee PEE EEE 
* CLEAR _ COMMON 
bd INDICATOR 
PREPARE FOR 
: DELI NKING 


SSCS SESH SETHE SESTE 


ESD30A0 
SOSH HGUS OSES DODE8 


6 

*GO TO NEXT ESD 
-->* ITEM-SAVE ESD 

° TYPE 


5 
SOSH HHH HHHHEES 


Lone, 


*c1¢ 
° * 
eee 


s 
s 
° 
* 
* 
5 


ESD1B 
seeseCSoeeseceosece 
6 e 
*ZERO BYTES 10, * 
> Ti, AND 12 of e 
‘ —EsD ITEM ¢ 


a %, 
DS %, 


e ® ° e 
NO .*IS THIS AN °¢, 
q{~--6, OBJECT MODULE. * 


*, .e 
*YES 


eosseroeseseesese 
e c 
¢ ZERO THE e 
---¢ SUBTYPE FIELD ¢ 
e s 

eeoeeesoesenseteees 


CoeeeFrSeoeeeencees 


*HEWLCDLK . 
e006 __6_6_0_6@ 


--->*BUILD ENTRY FOR* 


* CESD LINE IN *® 
* DELINK TBL ° 
COCO SEES TORE EOS 
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A Cc D 


002 6 
° Ale 
e¢ @ 
e 
ESD23 
SOSSCCAL SS OO HS SSHD 
SFREELINE e 


$$ 0_¢_8_9. 06.8 
® SELECT NEXT * 
Pea eh Te ; 


CESD 
SOSCSCEHHHHOESHSOHHS 
oos8 
e02 ¢ 
* Bi ¢-> 
* ® 
e086 


ESD23A %, 
Bi *, 


-*IS ESD ¢. 
«*TYPE LABEL *. YES 


*. REFERENCE .¢-------- >* RENUMBER ID ¢#--- 
. LR) -* sFIELD OF LABEL . 
. . ITEM 
o .¢ pessussneseeeeeecesaes 
N *o1 ¢ 
ooes * F2¢ 
202 6 6 
® C2 e-- ° 
° e i 
ooese 
.¢, ESD21 2%, 
ci s, C2 e 
-* *, -* IS ¢, 
-*IS ESD TYPE*. YES -* AUTOMATIC *. YES 
*.A SECTION DEF, *-------- >*®. LIBRARY CALL .%-------- 
®, (SD) o® ®, INDICATOR. * 
*. .¢ *, ON .¢ 
o, ¢ e ¢ 
* *NO 
Cn eesscesooee ses 
*, ESD22 


® o, 
.*1S ESD TYPES. NO 
*. COMMON sae aes | 
® 


o. 
e, ooe 
ewes ° 
* F2 
e 
ooee 
ESD42 
COOOOE] COO SES OOS 
; MARK omnon : 
ITEM AS A 
SDELETE ITEM AND® 
* SET COMMON 


* Twoic ATOR : 
OO000 COC CEEOEOOOE 


e690 
e02 ¢ @seeecssess 
° Fi e-> 
e s 
oo08 
SHOOT 19F0869SSH6 
ENTER ° 
ee TER, ge 6-8-6 
-->* ENTER ITEM *%<--- 
| ; IN CESD § 
$9609 98SHSHSSH8SSE6 
s e 
e e e008 
* ie * Loses * 
eon0 ® F2 6 
e e 
eeo00 


ESSsO W 


eee 
002 * 
* B2 ¢-. 
® ° 


oe08 
SHOOK QOS SSCS OSES 
td 


* LABEL 
0-9 _0_6-6_¢.6 6 


SCooesHZeseeee008 
*® INDICATE THAT ° 
*ESD IS SD Pc 
*- SET ESD ORITES 
; INDICATOR IN . 


OOF 9HHKTHHHSHEOO 


e 
® 
° 
4, 
E2 ‘ 
a s, 
NO... Is *, YES 
Sec-2 *. LENGTH ZERO, «Hanne ---> 
“e. Pe ti 
*, .* 
e 
eees 
s e 
e F2 6 
6 o_— 
oe6e v 
2%, 
F2. °°, 
e *, 


NO oe LD *. 
----- *. INDICATOR ON 3% 


e, .* 
*. .® 
*YES 
| oeoee 


>*01 ¢ 
: G3. ry 


por 


RT 2 OF 3 


TIT rik tii iii) 
* rs 
pet SD IS : 
*FPROM A_ LIBRARY 

” s CAUTOLIB INPUT) ¢ 


avesdeseeeseenees 


-* IS e, 
-* LENGTH ID *. YES 


: SAVED tees 
*, INDICATOR. * } 
. ON. 

*. 6 $ee8 
ono e ry 
* Fie 
e es 

ose 


SCOoeePieccecesece 
*SAVE NO LENGTH *¢ 
id LINE ADDRESS : 
AND SET ID 
SAVED TNDICATOR® 
s N APT ¢ 
Seeessseocsososes 


{ eese 
— > So 


* Fi ¢ 
e 6 
oeee 
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oocece 
e02 ¢ 
° Aue 
e @ 


ESD6A 
SeeesAysoseseetes 


* 
° SAVE TYPE O bd 
* MATCHING CESD * 
* ENTRY : 
* 


0000009966660 008 


SCH EBUSeeoooseos 
sIDCES D 

o-0_¢_ 6.0. 6_0_ 6. 
*DETERMINE LINE 
sNo- OF CURRENT 


CESD LINE 
seceseseebaneeeee 


eenree 


o%, 
cu eo, 
ae ¢, 
* S CESD *. YES 
es, TYPE NULL .*--- 
*, .* 
*. .¢ 
*. 3 eens 
*No *01 © 
° jie eee 
ee 003 ¢ 
° * Al * 
>e | 8 
NO 88 
2%, o *. 
D& e, DS ®, 

o *. .e *, 
-*IS ESD TYPE*. NO -* IS CESD °*. 
*: PR geo coees >*: TYPE PR. 
*. ‘ *. .* 
®, a s. .® 
* .® *. 

*YES oYes 
ri yt 
>*01 © 
e yi e 
eo 8 
oeee 
a® 
ESD9 or oe 
? "ts CESD’ *. NO 
e, TYPE PR grote 
“eo. 6 
* 4 eee 
*YES 01 ¢ 
e jie 
es 
ry 
%, 
Fa” “e, 


e ¢ e, 
NO ..* IS ESD %. 
---4%, LENGTH Pid 
ou GREATER “° 


“e. oo 

*YES 
SOOCOGHOC OOO EESES 
* . 


*SET CESD LENGTH® 
* EQUAL TO ESD °® 
° LENGTH * 


td 
$600 000668096 6668 


susssuaeseesseese 
° SET CESD bd 
*ALIGNMENT EQUAL? 
° x2 HIGSEST eer ; 
: CESD AND 


SOOODOO DESEO DEOOS 
ese 
->*01 © 
¢ F2 ¢ 
e ° 
ooen 
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e¢6¢6 
#03 « 
* Ale 
* @ eee 
cy * * 
* AY 6 
* e__ 
Vv one y 
4 a .*, 14, ESD12A _—s 
Al", A2 "*, ESD6C A} "*, Au’ "6, AS 4, 
.*1S ESD 6, .e °. 11S CESDS. 4 +. 4 *. 
.* TYPE WEAK *. YES .* IS CESD “*. NO .*° TYPE A | *. YES .*1S ESD TYPE*, NO .*° IS ER °*, YES 
*. EXTERNAL .¢-------- >*. «oo TYPE WX 0 @----- =e >*. CONTROL CARD 2 ¢--- *. DELETE/ 1 #-------- >*) UNMARKED | *--- 
*. REFERENCE. * *. 4 ‘, ¢ | +. REPLACE. ¢ *. (ESD) .* | 
*.(WX) .¢ *, .+ +. + +, *. : V 
+, ,¢ *, ,* . 4 rors. +, *, 18 eees 
+o *YES +o *01 * +YES *NO ‘ ‘ 
eoee * J1e ees ¢ D5 4 
->*0] © * 6 PY * ° . 
* Fz ¢ + * pS 4 eens 
* * > *-> 
Vv eee eee 
ie V a ESD17A .4 
ESD6B Bl *, esses poeesee esas OOCOEE Jes eeeeeees +, 5 2, 
: *, ‘ . * . +, .*IS CESD*. 
.* IS CESD '*. YES ° CHANGE CESD °* *CHANGE ESD TYPE* we’ Is cEsD "*. NO .* TYPE A ‘®, 
*) «TYPE WX 0] #-------- >* TYPE TO ER °¢ * TO ER ‘ *:TYPE DELETE/ . ¢--~- *. LIBRARY .*---, 
+, .¢ ‘ ’ ‘ + *, REPLACE .* *. MEMBER .* 
+, ¢ * * * * *, .* +, _* v 
*,. PRP PERE RR ERR EET ET | SHCCHEHHHHHHEHHHHHE *, ,* eee6 +, ,¢ eeeesd 
+No | * YES . ‘ *YES e02 ¢ 
*H3 8 * Bie 
* if * 
oo0% % 
icici soe See See Se eee oa Se 
Y 
ESD? cl "e, SHHHHCIZFECHC HHH EEDE c4 >, O98 6C 5 O909980048 
: : * SET CESD * .* *. * HEWLCDCN * 
.*' IS CESD "*. YES * POINTER TO. * .*” IS CESD "*, NO o_0_ 6. $_6_0_0_0_¢ 
*: TYPE CHAINED . ¢-------~- >* “CHAINED TOt #-—- *) TYPE DELETE . °--- *REMOVE LIBRARY *~-- 
*, .¢ " LINE ’ *, .¢ i * MEMBER FROM ¢ 
*. .¢ ‘ * oy *. .¢ ’ CHAIN . 
=; 2 [ERE ER ERERERERERERER EES *, + oo0% CET ERE RTECS ERE TEE EEE ET 
*hO #02 6 *YES * * #02 ¢ 
* Aue * H3 ¢ oess ¢ B16 
* ¢ a e s e * 
YY oes *p5 ¢ * 
» e¢_- 
4 eo08 
*. *, a 
Dl >, D2 +, SHHSHH FCS HHH REEDED +, seoesep SF esteseseese 
.4 : .* +. * ° aoe +, * CLEAR SUBTYPE * 
.* IS CESD "*, NO .*IS ESD TYPE*, YES * SE MATCH ¢ .*is ESD TYPE*, YES * DELETE BIT IN * 
*; TYPE ER .¢-------- >e, LR Peogouseys >* INDICATOR  ¢--- *. DELETE ae *CESD LINE (MAKE* 
*. .¢ +, .¢ . ‘ *. .* * IT A REPLACE) ‘* 
+, _* *, .¢ * * +. .¢ ° * 
*, 4 *, ,# SHH HEHSHSHSHSHREHTE HC HDD * ,¢ oee66 0966666644408 H8 
*YES *NO #02 © *No *02 ¢ 
¢ B2¢ | ee00 6 Alte 
* ->* ** 6 
* * Hl * 6 
* * 
Vv Vv eee8 
ESD12 .%, ESD14 4 ESD18 se 7 4 
“ ¢, E2. , E3) | #, Eu @, ES", 
.*IS CESO®, .¢ *. .? +, .¢ +, .*IS CESD*, 
.*ITEM FOR A’ *. YES .*IS ESD TYPE*, NO .*IS ESD TYPE*. YES .*° IS CESD "*. YES .*UNMARKED OR*. YES 
*:CONTROL CARD, + #---y *: SD Pesone esos >* CM oe Del TYPE PC i #--- ¢: NEVER CALL |: ¢--- 
*, 4 Vv +. .¢ * oo *, 4 +, .* 
*, 4 eheen *, .¢ +, *, 14 oeeee *, 4 ooees 
*NO *01 ¢ eYES +hOcTyPE IS ER) *NO +01 ¢ +o *01 ¢ 
e jie [ * He * F26 
e¢ 6 Lage ba * 68 oe ¢ 
* * 33 * % 
* » 
see8 
at , 2a ESD15 14 % 
Fl *, F2 o, F3 e, F4 o. eeoePcesceseones 
«# °., * *. «* *. -* *, 
.tIS ESD TYPE*. NO .*" Is CESD “*. NO .* IS CESD "*. NO .*° IS CESD "*. YES SMARK GSD TYPE ° 
*.CM, SD, OR LR. ¢--- +. RE CH eee >, TYPE LR .e--- *: YPE LR ,¢--- CHED * 
*, o *. .¢ +. .¢ +, . *UTYPE : ‘ 
. Pd ‘, «* +, -* +. «* IS cD) ° ° 
*. ,e sees *, ,8 * .e #. Je TTT) PeTI TIT IT IT TTT Tit 
*YES * * *YES *YES *NO * * | 
* Au ® on00 * G36 esse 
* * * * ° * —>*01 6 
ooo * G36 eeee °* F2 6 
e *-> * > 
eoa0 eo08 
ESD17 aes COMMON 
Gl s, Oo eeeGIesteeteetes SheseG tertsesoese POSCHEGHS OOS HEEEOS 
ot *, *SET CESD LENGTH® * DBLDEF ° * UPDATE LENGTH * 
.*’ IS CESD "*, NO * oper Ruat ° e090 e_e_e_e_s * OF CESD ENTRY * 
* "TYPE DELETE, . ¢--- GREATER OF CESD® * DOUBLE LABEL * * TO GREATER ¢ 
: : * AND ESD ITEMS ¢ * DEFINITION ¢ ° LENGTH ‘ 
*, .¢ Ps * ° ERROR Ps * Ps 
*, .*% es¢0 LR R ERR SEER ER EER SGT SCHHHHHHSCHSHEHHHOS LPR RE REE REE ERR ATE 
*¥ES ° . 
eee e BS * eo00 
* * * * * * Pe ee 
* H1 * oeee * HH} 8 
° > e +> 
oon eoo8 
vy CESDDLNK o®e ESD15A 
CoOOOHL OS O SSO FEE H2 F COOH Jeseeeesere oeeeeHbeosecceses 
¢ HEWLCDLK + .¢ +, *DELCHN * *HEWLCPTH ° 
_¢_0__@_0_0_¢@ NO .°IS OVERLAY *¢, +__6_0_¢_6_4_9_86 ¢_¢_¢_¢_¢_0_0_0_6 
° DELINK CESD° ---*, INDICATOR ON .* --~* CREATE A LINE ¢<--~----- * FIND COMMON ¢ 
* LINE ° *, IN APT .® *CHAINED TO LINE * PATH SEGMENT °¢ 
* *, .° *FOR MATCHNG SYM* ® * 
LER CRSP EE LET EET ES eee >. 9% PPSSHSHO SFP Se eeSeSHeeeoesees [RRR REE EERE REE 2 FE | 
*02 ¢ *¥ES *02 * 
eo08 * Be ® Fie 
->*02 e * ® * ¢ 
°* Bl ¢ » * 
* » 
ones YES 
OOOO TIONFONTEOES ESD16 ee fe 
* HEWLCPTH ° 
o_¢_6_0_6_4_@_4_0 els ESD TYPEe. 
* FIND COMMON ¢ -->*,  DELET 6 
* PATH SEGMENT ¢ | *, .* 
* . *, .¢ 
OOOOH FCHHHHHHHBES aoe *, ,% 
° ° *No 
ooee *jJ306 [ eeee 
->*02 * * * —->eol «6 
* Bl ¢ ooee * F2 3 
» % * 
e000 soos 
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FROM OBJECT 
OR LOAD MODULE 
PROCESSOR 


SOO DIVO +C Se eFe8 
* 


: HEWLFRAT 


* 
* 


; ECPRG 
rok nr oe SOeeeCYOeeeeneses 
* +. *kKLDOBUF CKAi* 
.* *. YES 0. _0_0_ 0 446 
*, END OF DATA . *-------- >* WRITE OUT RLD * 
*, .¢ * BUFFER * 
*, .* * * 
*. .° Seeeerteonreeseres 
e*. 
D3 *, OOTHEDUSH COROT ERS 
.* *, *TXTBUF CHA3* OOD 5 eeeeeseee 
»*INPUT COUNT*, YES o- 4. 6466-64-48 * ° 
*, = 0 «%--- ® WRITE OUT TXT *-------- >* RETURN * 
*. _¢ } ° BUFFER ‘ A « ° 
*. .¢ * e | COCCCESEEEEEEED 
*. .* eee Soeedeeeeseserere eee 
*NO * * * e 
* D5 * * BS * 
* * * e 
eeee eee 
%, 
E3 *, 
ae *. 
RLD .¢ *, T 
----------------- *, RLD OR TXT. #----------------- 
“e. .. 
*, ,¢ 
° 
*, o*, 
RATIN F2 *, SOCCOF JOC FORO FETE Fa e, 
~¢ e, ¢HEWLFLOG GCA2* .* *, 
»*INPUT SIZE *, YES #4 6_0-6_6_6_%_6 YES .*INPUT SIZE °. 
*, EXCEEDS RLD . *-------- >¢ INPUT RECORD *%<-------- *. EXCEEDS TXT .* 
*. BUFFER .* . TOO LARGE : *. BUFFER he 
“ee. ue OOOH EREOE OEE * .¢ 
*NO | *NO 
rer repli cere e iad Perri le CECE) 
*RLDOOL CJA1® @ HEWLFTXT CGA2* 
o-¢_b_6_ 0.6 _6_0_6@ o_6_9_9_0_0_6_8_e 
* PROCESS RLD §& * PROCESS TXT * 
: RECORDS : ; RECORDS : 
COCO EHO SER OOEO ES SOOO EHEEEDEOHEOE 


SOSH JOC CbeRERe 


e 
ne ee ee >» RETURN Oko nnn nnn enn ne nne 
9 
PPP PEC EER UES 
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CHART CG. TXT PROCESSO 


SHHSADASSCSESEHS 
6 s 


sf HEWLF TXT : 
SCHOTT EE EE EES 


TXTLM -*, 
B2 * 


.* ALL *, 
YES .* ID-LENGTH *. 


--+*, LIST ITEMS TO. *< 





! *,BE DELET-.* 
*. ED .e 
eeee *. .f 
* ry *NO 
* BS e 
s & 
ese8 
Vv 
TXTREAD .*, 
SOHC] OO RHEE TE EEE c2 e. 
.* WILL ¢, 
‘ ‘ YES .*RECORD FIT *. 
READ RECORD <-------- elIN AVAILABLE .* 
° A *. BUFFER |.* 
Ceeeeeeereserese *, oe 
*No 
Vv 
SHeHE HCL ESF eeeseee SCHeSeH2eseeeseeses 
¢ RENUMBER ID, ¢ *TXTBUF CHA3¢ 
*UPDATE TXT I/O * e_ 0 6_0_0_0_s_0_e 
-->*TABLE AND TEXT ¢ = |----- *WRITE OUT TEXT * 
¢ NOTE LIST ¢ * BUFFER . 
CeCe eeeseeeeeseeseee SETS SSH SSH SE SE 
Vv 
TXTLM2 .%. 
El e SCOSCOE DOC C KEE STOOD 
.¢ *. SMOVE, FOLLOWING * 
.¢' ID TO BE '*, YES * ID'S UP TO °¢ 
*. DELETED .¢-------- >SOVERLAY DELETED® 
6, .% 6 ID e 
6. a e e 
*.. .* eeeeeeeesees testes 
*No 
€--- e+ ee ee ee 
.*, 
Fi" “s, 
YES 
-==*l ANY MORE ID'S. es 
Pe a 
s. ,* esas 
s s e 
*pse 
e e 
eee 


C(HEWLFTXT 


. 
» , LORD MODULE |. * 


TXTO011 -*. 
C3 


-¢ °, 
-* IS TXT ID *. NO 


Vv 
SHOE H FEC HORE OOES 


s e 
e e 
* RENUMBER ID * 
e ° 
e e 
id e 


SSCS SCSCSHHCHSSHSE 


-*. 
E3 *. 
.¢ * 
. *, s 
*, DELETE .*--- 
e, .¢ 
*. .* eeoce 
*NO e * 
* Bs ¢ 
e e 
eeen 


00151 
SCoeePZeeesereses 
bd CALCULATE 

: MULL ELLCIEY 
° 

e 

e 


e 

e 

AND . 
DISPLACEMENT ¢ 
e 


SOFSCSTSCOHHOHSEHSSE 


« *CURRENTS. 
-*ID AND MULT®. YES 
e AGREE WITH .¢--- 
*+ PREVIOUS |. * 


TXTINT *, 
G3 


e .* 
*NO 


TXTOO3 .*. 
H3 


TXTNEW *. 
J 


.* LENGTH 
*: SPECIFIED IN .*----- 
*.  CESD |.¢ 


*. ,¢ 
*NO 


SeK Jeee¢ens 
* td 


*SET NO LENGTH® 


* INDICATOR *------ 
° e 


td s 
Seeoeeeeeeee 


. AN SD OR Pc , #------ 
* e 
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*, 


AW (fe, COeePAS SOEs eeeeeS 
-% e, *TXTBUF CHA3¢ 
«* ONE PASS *, NO o_o. 6. 6. 0. FO OO 
-->*, PROCESSING, *--=------ >* WRITE OUT TXT * 
. -* * BUFFER ° 
*, 0? ° e 
*. .e erTrrrT eI rir rrr iit: 
*YES 
oeee 
r * 
¢ BS e 
¢ *-> 
oes 


eeeeRSececcooooe 
e 


RETURN ; 
pererevcrerese® 


SOCECHS SCOR OOEE 
*HEWLFLOG GCA2¢ 
o_0_6_6_e_e_8_e_¢ 

-->* INVALID ID ON : one eee eee ee 
. TXT CARD bo 
SCoeo ee eEEeCEEOESEE 


NO 
ES . CoEFTEeESeeesossses 
.¢ *. ¢TXTBUF CHA3¢ 
.*” NEW ENTRY *, YES ¢_¢_0_¢_¢_¢_6_¢ 8 
¢. CONTIGUOUS 1 ¢----- ¢WRITE OUT TEXT * 
. .¢ ¢ «BUFFER ° 
e. 6 e e 
s, ,% SOSOHSHOSSCHOHSEHOSSS 
Ld 
A 
YES 
Fu e, ecocePoecoceseces 
.¢ e, e e 
.*” PREVIOUS "*, NO ¢ ENTER NEW  ¢ 
~--->*. RECORD DENSE * ¢-------- >¢ — RECOR ¢ 
"ee, 6 ° ° 
* ,®8 SEOHHKHSHSHEHSEEEE 
s 
eeee 
>e ° 
¢ BS e 
e * 
eoee 
TXTOO3B 
Ga“ e, 
ee s. 
NEW" s, 
-->e! MULTIPLICITY, prepa 
Ms | 
* eeee 
aes e rs 
e Ky 6 eoce 
s s 6 s 
cece e B5 e 
—>e e 
eee 
TXTOLD2 48, 
H4 o, corns 200006006 
.* e, e 
1° VIRTUAL | % YES : ENTER IN TXT ¢ 
+», STORAGE ,°°-~---7-- a ; 
e, a? e ® 
* ,¢ COSCO HHHOOCHH OCHS 
eo A 


ee JUSeeeoce 
° . 
* SET DENSE ® 
se INDICATOR - 


* * 
CeoSeeeseses 


ooee 
r e 
¢ KK e@ 
e *-> 
oon 
BUPA 


LLOC 
Sooo KH OOS eSEEOSE seseenss oseneees 
° 


* ALLOCATE NEW °® : RECORD IN TXT ° 
-->¢* MULTIPLICITY ¢-------- >¢ I/9 annie tet s e 
rs * *TEXT LIs 

Ps Ps 


SSHOSHOSHSESESESESOSS népecees cess ssoes 
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CH. T RI OUTINE 


<_< ee eee ee eee ee eee ee ee ee ee ee 


e*%. 
SOKCH HLT OF OC eee ETE H2 *, 
ADD PRESENT ¢ ¢ *, 
LENGT (9) ° YES .* THIS MULT *. 
ACCUMULATED ‘¢<-------- *,. ONE LARGER .*<----- 

LENGTH D4 *. THAN LAST. * 

SSE SESE EEECESEE “e. a 

*NO 


@eenane 


J2 °. 
* *. 

«* PRESENT *. NO 
MULT = Q * 


KZ te 
YES .*LAST ENTRY *. NO 
Sooocueeee ------"*/ HIGHEST MULT. ¢—---- 
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N SYSUT1) (T UF) 


OveAR IFoo eesese 
° 


TXTBUF . 
CRORE CEH ERODED 


o%, 
B3 s, SOSH HUSE SE HEROES 
o* *. * CLEAN UP bd 
-* *. YES ° NECESSARY id 
*. END GF DATA .*%-------- >*PORTION OF TEXT*-- 
e, * * BUFFER * 
*e, * e * 
*, 4 SOSHHHE OEE EH OSES 
*NO 
2%, 
c3 *. 
Pa ¢, 
«* TXT INPUT ©, YES 
*, COUNT = QQ) , #--------~---++--+----+-+=-++----+- 
e, .* 
, ~* 
*,. ,* 
*NO 


TXTBUFI ~*. 
D3 e 


* o 


.* OVERLAY “*. YES 
*: SPECIFIED .*----~ 
se, 7* 
*. .* 
oe. 
*NO 
*, TXTENT1 
E3 *. CeOEU OC ee eeeeeee 
.¢ , WRITE ONE 
.*MULT LARGER*®. YES * RECORD PER ¢ 
*: THAN SYSUT1 .*-------- > TXT 1/0 TABLE --- 
*, . . ENTRY r 
. . 
65 Pa SCHOSOCHHOHCESHCEE SBE 
*NO 
eeen 
e e 
6 F3 e 
e e_> 
See 


Vv 
Coeeerzeeeoseress 


* 

*RECORD CURRENT 
* LENGTH AND 
QBUFFER ADDRESS 


* 
s 
s 
6 
* 
SESCSCEHCHESCHE EO HESE 


SOeesGjeocsoccsese 
° 


° 

* INCREMENT TO ¢ 
-->* NEXT TXT 1/0 ¢ 
: TABLE ENTRY ; 

e 


TXTBEND «%, 
H3 


e. eee Hbeeceseseces 
a e, 

NO .*ALL TXT I/O. YES * WRITE ANY * 
---*, TABLE ENTRIES. ¢-------- > ACCUMULATED --- 
*. WRITTEN . ¢ * LENGTH * 

“es ue wrerTrr Titer rte eT 
* 


COR TI OOOOH EO ERED 


% WRITE 
--> ACCUMULATED 
* LENGTH * 


SOSCKCHSESESHEEEES 


Soese Ki Seevesesos 
° ° 
* INCREMENT TO ¢ 
4 NEXT ENTRY e--- 


e 

e e 
C$OSCKHEHEEEHHEOHHHEEKEOE ESE 
e e 
°e® F3e 
e e 
eee 

Logic 


Copyright IBM Corp. 


$4600B 56 eeesesees 
° * 
*POST LENGTH IF ¢ 


weeeee >*¢ IN NO-LENGTH * 


: SITUATION : 
Seeeesooorereeeee 


eeeeCheecessces 
* * 


RETURN : 
Coterereeeeeres 


COCCES + CO eee CES 
° * 
RETURN : 


Seetesesesoeses 
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CHART CJ. RLD PROCESSOR (RLDOOL) (PART 1 OF 2) 


A2 “®, OUCOOA IOC COORESEE 
COOSA SOE SeEES .¢ o. *RLDBUF CKAI ¢ CoeoAUooseroese 
e se 6 . YES 6.6. 6_6_0_0_0_0_6 e ° 
° RLDOOL Onn -- >*. ‘FROM EOD « #--+------ >*® WRITE OUT RLD ®-------- >® RETURN e 
* ° e, _ e BUFFER ° e Ld 
Ooeeoeseseoeses e, .¢ PTTITITT TT TTT ii) 
ee rorrTITTT TT TIT TT it 
*NO 
oes0 
oo1 ¢ 
* B2 ¢-> 
o ¢ 
osee 
SFOSTH HI SOSCCSESESEE 
° ° 
® SET COUNTERS ¢ 
®FOR NEXT R AND ¢ 
: P POINTERS : 
PTT TTI TIT iit tT) 
oo, 
c2” °e, rTrritetiTrttriit) 
«* e, td e 
-*IS P DELETE*. YES *®SET DELETE FLAG* 
*, IN RNT » @-------- >* AND SKIP RLD °& 
° . ® ITEM ° 
: .¢ Pe Ps 
*, .6 rT IT TIT itty ty) 
®NO 
RLDOO3 2%, 
be senleeesesoocs D2” “*e, 
*RLDBUF CKA1¢ 
0. 0_¢_0_6_6_¢_8 NO .° P SAME AS ¢ 
¢ MAKE BUFFER $<-------- *; PREVIOUS P .¢#<---------------- 
rs Ps "e. o 
SOCCO RO OEEDOSOORS *, .* 
*YES 
RLDOOWA 
rTTTY) viTT TILT itt 
e e 
*RENUMBER R AND ® 
So cesececl ccc >* P POINTERS * 
Ps e 
e Pf 
PrYTTIT ITI TTY it 
o*, 
TIT yy sty titi tit) F2. 6, 
Ps DLK Ps Py e, 
o_0_9_8_0_9_0_0_8 YES . 
° eGckecoace ¢: DELINK :° 
e DELINK ° 6, Pied 
Py Pe ®. 7) 
PYYyTiIrrTittiT iyi? ¢. .¢ 
*Nno 
op ee > 
o*%, RLDO10 2%, 
G2 *. a 
Po s, e Is R 
ides FLAGGED*,. NO . SEU « YES 
-=->¢, ‘4 o® ee ee S222 22 2 ee eS 4 SSS e223 Se r= >e, REGIS R IN a ee ae, 
ore TYPE o¢ *, R . 
“oe, .e" “e. 4e” 
*YES eNO 
.%, s e 
H2 o, Ha e 
e e, % s R e 
° NO YES .* £ 
s, OVERLAY o® Germ OCC SST e whee | 4 In o@< become mena 
*e, “e, - 
*, ,* *, .* 
YES *NO 
ALL 
TTTINPIIITIT STITT) eevee »jsjeccoccecce Oooo THOS OOOROOEE 
° SET ENTRY IN : Par dat ter a o-0-¢ : : FLAG R FOR : 
¢ CALLS LIsT ¢%-------- >* ESTABLISH ¢<---~---- ¢ RELATIVE °° 
: ; ¢ MULTIPLICITY ; : RELOCATION : 
PTYIiriitirrrirtty PrYTITITIT TTI tity PyrYrririiT iti iit 
RLDO122 o%, 
TITTY) sit iitt titi K3. 8, 
4 ry x) e. 
*UPDATE COUNTERS* YES .* IS RLO ¢, NO 
--~-* POR NEXT FA ¢<-------- *; CONTINUATION .¢-—- 
; FIELD : *, FLAG SET .* 
TTS TITiTiiitit yy “eo, oe oeeee 
* 002 ¢ 
* B3¢ 
ar) 
P 


seseeG5ecoeecceses 


* FLAG AS PR 
> TY 


esoee 


e 
Shoseseseeseoseses 
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HART CJ. RLD PROCESSOR (RLDO T 


CEES 
02 6 
* B23 e+. 
¢ 
ees i} 
RLDO13 4 
BI 
s s, 
_¢ *, YES 
*, DELETE a ten 
*, .* 
*,. .* 
¢, 
*hO 
eS eho Me oe es > 
| RLDO15 * 
6686 C 24446668666 3 *, 
*RLDBUF CKA1¢ Pid ba 
6_ 4.6. 6_ 6.6. 6-6-6 NO .*SUFFICIENT *&. 
* WRITE OUT RLD ¢<-------- *, SPACE _IN .¢ 
bd BUFFER * *. BUFFER eee 
s ° « 
SESE HHEHHTHEHEETESE *, .* 
SYES 
. e, 
$4066 D24666668bC88 D3 e, 
° ° ; *, 
* * YES .*1D SAME AS *. 
* COMPRESS va -------- *- PREVIOUS ID'S. ¢ 
bd . ° 
* * *, 4 
SHSSHHESHEEHHSEHEOE *, .% 
SNO 


SECHOHHEEISESCeeoseeses 


* 
*MOVE RLD ITEMS *¢ 
>t TO BUFFER : 


6 s 
SECKHEHOSSHEEEEHBEEE 


RLDO152 «% 
F3 *. 
.* * 
NO .* ALL ITE 


MS°¢, 
---*, PROCESSED : e<-- 
*, * 
e, .* 
eeees *, .° 
#01 © *YES 
* p2¢ 
* 6 


eoeeCeeeeesece 
* rs 
® RETURN * 
e e 

CoC EEE HOES EE 
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HART CK D WRITE ROUTINE (RLDBUF ) 


jXo 
e e, e a .* e 
A2 *, A3 *, Aa ¢, 

CORAL Coceseeee .* *, .¢ *, .¢ ¢, PreTy CTTITT TY TT 
* ¢ ~* *, NO * *, YES * ¢, * 
° RLDBUF ¢-------- >*. ANY NEW RLDS. ; #-------- >on EOD yiteronnoe >®LANY RLDS LEFT. ¢-------- >e RETURN ° 

TTT TIT Tit Titty) e. .. "eo. a “e. .e oeeceseeeceeeee 

*, e. 16 *. .¢ 
YES e YES 


RLDBUF1 . 
B2 


ibd s. NO 
°. 9 LOAD MODULE .. e------ wo -------- 


-*. -*, RLDOBUF 3 o*, 2%, 
Oo eeCLOseseceese c2° “e, cz) ve, *, cS ef, 
* LOG  GCA2¢ *, -e °, a) *, .* e. 
OF 6-6 _6_6_6_8_8 YES .® OVER *, NO -* BUFFER *, NO «* NOTE LIST *. NO * ¢, NO 
Pe $fosenoe ¢:) MAXIMUM SIZE .¢---~---- >*, OVERFLOW .¢-------- >*: FULL (eaetaseee >*, EOD ue 
¢ ERROR ROUTINE ¢ °; .¢ *, .¢ *. .* °. eo 
° e ®, .¢ *, 3 e. .¢ e. .¢ 
Prrrrrrritit iti itt, *, 18 *. .6 Ce e. ,¢ 
* *YES *YES YES 
sees | e008 
® Ps ->e ° 
* p2° * p2¢ 
e e-- ¢ * 
eees eens 
RLDBUFUA .*, RLDBUF2A_.®. 
Coseepzesscesecce D3” "e. DS -¢, 
Sees] esecceses Pe Pe _e e, a) ®, 
* e ¢ SET TWO PASS * YES .*°2 BUFFERS *. YES . 
: RETURN ; : FLAG Sones FULL Pde rr er re ree eer eeee- - TWO PASS ¢ 
Coecceseesecces e ‘ e, .¢ “e. Ss 
PYTIrTiTiiitiritity e, ,e e, ,¢ 
eNO eNO 
.%, 
Cooeexezeesececece E3}° ‘e, 
¢ Pe * e PTITIT TTY T TT TIT. 
¢ FORMAT NOTE ¢ YES .¢ ¢. NO ° . 
: LIST ENTRIES oes -------- we EOD ae woe ap RETURN e¢ 
e * ®, .* Yer TTITT iT TTT 
LTPP PETE EER ETE es, .# 
6 
RLDBUF6 o*, 
F2° “8, SoesePfucecesosese PY TITS TIP TTT Titty 
,¢ *, Pe Ps Ps ° 
-*ANY BUFFER ¢, NO *MAKE NOTE LIST * ¢ SET IN-CORE °¢ 
*, WRITTEN » #---- -+-------- -- - - -- -- + -- --- ------ > ENTRY #<¢-------- e DATA o<¢-- 
e. .¢ Pe * ‘ 
e, 8 e Ps e Ps 
e, 8 PerrrTrrTiT Tritt i iy Ooeesecccssoocccs 
*YES 
RLDBUF7 o%. 
$400G20000 C00see Gus“, eeeGhecoeccceses 
*¢COMCHK e * *, 
@_¢_6_0_¢_0_0_0_8 _¢ *. YES . 
oon ee ee >*CHECK/NOTE LAST®*---------~----------—------------ *, LIST FULL .*%--------> WRITE LIST 
e WRITE e s, .¢ Ad 
¢ ®, .e 
Coevesesecseerece e. 18 os eccccccescesees 
sno 
YES 7 
e -*, RLDBUF7A .®. 
H1° “¢, rer) PITT ITT IT TTT H3” “8, Hu’ “e, 
-¢ es, Pad , ¢ ¢, 
* s, * Ad NO .* 2 BUFFERS *, YES .* 2 BUFFERS *, 
wees EOO » §¢€-------- ‘ WRITE BUFFER Py €-------- s, WRITTEN a * wee ----- s, FULL Pa @€----- - -- -  - - - --- 
*. .¢ “e, ss “eo, a 
e, .e Coeeeeenecceeree e. .* *. .¢ 
*NO *YES *NO 


sees y jeesecoese 


PREP TIE EEL EES) 


RETURN oo -- 
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CHART CL. END PROCESSOR (HENLFEND) 


OC AL OOS SHORES 


* 
HEWLFEND : 


$009 OF FOSS SHH OE 


0000) Heese 8908 
* INITIALIZE 
* RENUMBERING 
*TABLE AND CESD 
SBASE REGISTERS 


$0069 F0SSH0S08 


eeteat 


ci +, 
-*IS THE *, 
YES .*ENTRY POINT®, 
~~~ *.BIT ON IN APT. * 


Dl "8. 
~* *, 
NO .® IS ENTRY "¢. 
<--*. TYPE ABSOLUTE. ¢ 


°, 7) 


*, .¢ 
* YES 


ENDO3 
SOOTHE] VOSS SE EEEs 
*RENUMBER THE ID®* 
* FIELD FOR * 


® ABSOLUTE . 
* ADDRESS : 
e 


0900860088684 F68008 


OOO FOF] OOst eS Ee08 


e * 
*SET ENTRY POINT® 
; BIT ON IN APT bs 


td * 
SHSHSCHDE RSH HE HEES 


END1 e o, 
Gl * 


. * 
«* 1S NO *, 
*, LENGTH BIT ON, *--- 
*. IN APT .¢ ] 
. Vv 
*, .* oeee 
*YES cd ¢ 
* AJ © 
* * 
oee0 
e ¢ o 
H1 *, SeeseH2Zeetesesens 
ad *, <HEWLF LOG GCA2* 
«* IS LENGTH *. NO o_b_é_¢_e_e_s_8_8 
*. GIVEN IN END .*-------- >*NO LENGTH GIVEN® 
*. RECORD .® * FOR CONTROL * 
. . ® SECTION * 
*. .* COSHHEEEEES OO OSES 
*YES 
Fa ae a ae ee ee ee 


ENDIA 
SCOCOR TL SOSH OSEESS 


*PUT LENGTH INTO* 


T 
; SECTION g 
SOROS SHOSEE TEN OEF 


HOECE KL OOOOH OO EES 
: TURN OFF ‘NO 


LE 
* INDICATOR IN 
° APT 


* 
* 
* 
* 

Py * 

Soereneseoeeserese 

etee 

->* * 

* Aj ® 
* * 
oeee 
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eee80 
* * 

* Aj * 
* e- 

ooe8 

END2 

OOOO00/) 3960006066464 86% 
. CLEAR * 
*REPLACE/CHANGE * 
*BITS AND SYMBOL* 
+ COUNT : 
s 

CEES ERE EE EER SEE EE 


$F O9S Riebeseeeee8 
* SET UP LOOP * 
*INDEX TO REFER *® 
*TO RENUMBERING * 
4 TABLE 
SOK EHORORS OSES SE 


.* s, 
.*IS RNT TYPE*, YES (EITHER) 
*; (DELETE OR...4 @22-4-4 25-264 444-40s5e-sse—6 
+, CHAIN .* 


*, ,¢ 
*NO (NEITHER) 


END10 
HOF HJOSseeseses 


® 
* 
RENUMBERING *¢ 
TABLE ENTRY : 

* 


1 
* 
* 
. ZERO OUT 
. 
° 
OHSS HOSES EHEOES 


END10B -*, 
E3 . 
.* *, 
NO .*IS RNT LOOP*, 
DONE see 


*, .* 


*, .¢ 
*YES 


eeeoserisseseetsees 


. * 
* * *SAVE CESD ENTRY® 
* RETURN * *NUMBER AS FIRST®< 
= - * OF THE CHAIN * 
Ooo ESOSEETEO SS * * 
SHCHEHH HONE SEOSEES 
TO INPUT 


PROCESSOR 


cee isesessese 
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7 

SOHSSAFL SHES EE SSES 

* * 
* REFER TO CESD * 

---->* USING RNT ID * 
* VALUE : 

* 

HOSS OeSESEEESOEES 


o*, 
B5 s, 
*, 
CESD *. YES 


-* IS 
*, ENTRY'S TYPE . *--- 
*, DELETE a 


NO .¢® IS CESD 4, 


--41 ,;---*. ENTRY'S TYPE .* 


*, CHAIN .* 
*, .* 
*, ,¢ 

*YES 


Poses ss 


ry 

$OebtD 5eseeserese 
rs . 
*BLANK OUT CESD * 
* ENTRY : 
* ry 
escecoesreseneees 


POSSE ESS OC OEE EOOS 


+ * 
* INCREMENT * 
*ENTRIES DELETED* 
. COUNT . 


0999909006604 0946 


«*, 
FS a, 


.* s, 
YES .*IS THIS THE*. 
-------- *. FIRST DELETED. * 
* NTRY * 


SOSSeGSeseseceses 


®USING INDEX TO * 
* LAST ENTRY OF * 
*CESD CHAIN-PUT ¢ 
* onnee ENTRY  ¢ 


IN CESD * 
SESSSESC CES ESE OOES 


END6 
SeeeeHsheseceegese 
* PUT ENTRY ° 
: pEheTEe cesp : 
* z iN KET ° 

* tT OF CHAIN * 

Pye YTT Ti Titi iii 


1972,1983 


This document contains restricted materials of IBM. © Copyright IBM Corp. 


LY26-3921-0 
HART CM. CSE 


“ENTER HERE 
FROM INPUT 
PROCESSOR 


SOOHH EL COC CC COSHH 

*.HEWLFLOG | GCA2$ 
oe e_ ee _ eel ee NO 
WRITE OUT 6<-----"—- 

ERROR MESSAGE § 


s 
td 
¢ 
SCVOSCHEROSHEOESESE 


COCO] OOCESEEES 
. * YES 
bd RETURN 


OFF G 1 OSCE SOOEES 
SIDRSPZAP CPA2¢ 
-@_6_¢_6_ e-e_6_¢% YES 
cADD. SPZAP DATA *<------=- 
* TO TABLE . 


SOSSeseeeseseseeses 


ooee 
_>* * 

* Gu e 

* * 
eee 


IDENTIFICATION RECORD PROCESSOR (CHEWLFIDR) 


rer Ty WEE eer 

* * 
* HEWLFIDR * 
* * 


Seebenzeses esac es 


* 
. 
* SAVE REGISTERS ; 
* 
OOo seororeresooesS 


SSCCECZ ODEO OSEOEE 
Ld ESTABLISH 

bar father et 

: FOR MODULE é 


: 
SOSCHCHHHHHHHHHHHE 


| 
4 


.* IS INPUT "®. YES 


+ 
° 
* 
APT * 
* 
° 
. 


.* . 
-* IS_ INPUT ¢, 

*,. LOAD MODULE .* 
e, IDR 


te se" 
YES 


-*, 
F2 *. 
ad 6, 
-*IS SUBTYPE *. 
sat See LFED Pas 


G2. 8, 


-* s, 
-*IS SUBTYPE ¢, 
nes SPZAP .s* 


Hz” +. 
.*IS SUBTYPE *. YES 


*. TRANSLATOR oo ------ 


2 . 

.*LS SUBTYPE *. YES 
¢, “USER DATA 
“ey, .o 

*, ,~% 

eo 


oeeeK2eeeneeeens 


HEWLF LOG GCA2*¢ 
—*.,¢-¢_¢_¢_¢ 06 


WRITE. QUT : 
¢ ERROR MESSAGE 
pceedadeseVawneee 


- OBJECT END. *------ 
* e 


ENTER HERE 
FROM CONTROL 
STATEMENT 
PROCESSOR 


.* DOES IT "¢ 


E3) "8, 
-*1IS IDR, *. 
. FIELD *. 
+: DOUBLE ENTRY. * 


Vv 
COSSEPZI OF SSS oEEES 
° e 
*TURN ON OBJECT * 
. END INDICATOR : 


* * 
SOCSHEHHHEHHHHEES 


SOSCEG ECC OE EEOES 
STORTRANS ‘ CNA2® 
¢ ADD INFO TO * 
¢ TRANSLATOR . 
e TABLE bd 
PT eI e rir 


TErisy etree rit) 
° 


* 
* TURN ON LOAD # 
>e MOD IDR * 


: INDICATOR . 
Coos eroseeresese 


eoee 
. * 
e*j3¢ 
* e_- 
eee 
OO OFT JOS CSE ESOS 
SIORIDENT COAz® 
: TO TABLE : 
SOSHE SEER EEE SHEE 
* 
* 
. 


awe ee oe 


YES 


woes ____ys ADD USER DATA e--- 


SOOCAU SHO HE CEES 
* * 
-* HEWLF IDR * 

* . 


Pesto RUeseosegsese 
Cd 


6 
* SAVE REGS & *¢ 
* ESTABLISH ¢ 
*ADDRESSABILITY ¢ 

s 


OOOCOCHOCOSES SECO 
. TURN ON . 
° IDENTIFY . 
* CONTROL CARD ¢-~-- 
p4 INDICATOR : 


COE HOS HEED EEE EEOEE 
e e 
¢ 33 6 
° * 
ooee 


SeeeeHPuUseeesseeeee 
* HEWLFLOG GCA2¢ 
e869 6. 69 tt 
>e WRITE OUT e 
: ERROR MESSAGE bs 
SOSH SHHHHHHCHHOHSH 


COSCHHEUS OCC OOOO EOE 
e o 
*TURN ON DOUBLE * 
> SENTRY INDICATOR¢ 


* * 
66SEC HHH HEHE 


oo08 
e e 
¢ Gu e 
e e_. 

eee8 
SOSH CUSOOHCE CE EEDE 

o 6 6060656 O66 08 
e * e e 

>¢ RESTORE @o22552 55 > RETURN * 

¢ REGISTERS ° e ° 
o e TEPER MER ERE EET 


POSS HUO OHO SEES 

$ IDRTRANS CNA2® 

e_¢_¢_@_¢_e_¢_0_6@ 
>*ADD TRANSLATOR *--- 

: DATA TO TABLE : 


SCHOSSHESCSSSESSHSESEHHTHEHSES 
e 
* G4 
e 
eoe8 
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OOCOC]L COE EE SEES 


*HEWLFLOG GCA2 * 
#_¢_¢_6_¢_e_6_e@_6 NO 


* WRITE ERROR *<-------- 
: MESSAGE 7 


OOSCEH HEHEHE OHES 


wer le we wwe we ee ee KK 


PATH FROM 
THIS POINT 
WN IS 


bo I 
SHARED WITH 
IDRIDENT RTN 


we wee He eo ew ew et ewe wee 


SOC AZP OC ORES EEE 
e cy 
*  IDRTRANS * 
e e 


SEHCHSCHCHHHEHHS 


o*. 
B2 *, 


*. 
-* IS OBJECT *. 
ve END apne 


® 


. Ol . 


c2. "8, 

.* *, 
.*IS LOAD MODs. 
*: IDR INDICATOR. * 
¢. ON .° 


*, _¢ 


e, 6 
*YES 


.*, 
D2 *, 
»*IS LAST*. 
«* ENTRY IN ¢, 
*. TABLE 4 
*- COMPLETE |. 


*. .f 
*NO 


SCHEOOE 2 OC ORO EEOSS 
* * 
bd TURN ON . 
*CONTINUED ENTRY® 


* INDICATOR * 
» * 


SHSSTHHHHSSHH OHH HS 


ovecerzeseeoonces 
*POSTIDR CRA2* 
e_0_6_0_0_4_8_0_¢ 
* FORM COMPLETE * 
; ITEM : 
SOSH EHS HHO SE OEES 


PERE Tepe EERIE | 
* 


% 
* POSITION TO * 
* NEXT INCOMING °¢ 
¢ ENTRY * 
CREP EERE REE ERE RSET) 
eee6¢ 
->e e 
s D3 e 
% 2 
ooce 


>*ADD ITEM TO IDR* 


IDR TRANSLATOR DATA PROCESSO 


PoSSeHOSCesoovons 


*POSTIDR CRA2* 
o-¢_6_0_ 6.0. %_t. 8 


® TRANS DATA ° 
° TABLE . 
COFCO EEO DOO EEE 


cooe 
* * 
*p3°6 


e e_- 
eevee % 
%, 
D3 ¢, 
2% *. 
e* IS THIS *, NO 


>e. ENTRY oe #---- 


*, COMPLETE .* 
*. _¢ 
*. ,¢ 

*yYEsS 


SOHHHE OOO OS SORE 
*POSTIDR CRA2* 
6_e_¢_0_0_0_t_6_8 
* CORRECT CESD * 
*LINE NUMBER(S) * 
° FOR ITEM * 
SOOSHHEOR ESET OD SOS 


-*, 
F3 +, 


Pd a 
-* ANY MORE *. NO 


¢. ENTRIES 2 #-+-- 
e * 


wee ee we ee mee 
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HEWLFID 


CHOC HUSH HHHEOHS 
® * 


----># RETURN * 
e e 
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OOeSEHSeeseeesees 
*POSTIDR CRA2* 
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-~-->*ENTRY INDICATOR*-------- >* ADD ITEM TO °¢ 
° bd * USER DATA OR * 


° * 
SOSCSHHEHKHHHEHHHS 


*TRANS DATA TBL * 
COFFS ESEH OO ESESS 


SCOSCE SOO seeeses 
* 


RETURN : 
SOHC ESEOEOOES 


SOSOPUSCESESHSS 
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SCOCCAZ OO OE SORES 
* * 
: IDRSPZAP ; 

COC OSE OEE EE SES 
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B2 *, 
-* DOES *. 

-* INCOMING *. 
*. RECORD CON- .* 
*. TAIN ANY .* 
*.DATA .® 
*. .f 

*YES 
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C2 s, 
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-* IS FORCE *. 
*, FLAG_ON IN .*# 
*, IDR * 
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° DETERMINE * 
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* IDR * 
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SOSH OTH CEH EH ESS 


SOOO EZ FCO +CEES 
s 
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OOS HI2ebee senses 
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DATA TABLE 
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eete 
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* UPDATE TABLE * 
*END POINTER BY * 
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SOSeSeeSeseessese 


Cees Bieseeseeee 


RETURN 
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CCE OECIT EH OSO SEE ES 
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* TURN ON FORCE * 


* 
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Seveoveseseeseeees 
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* 
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G3 


+. 


* ANY *, 
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>*. ON THIS REC. 
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*. 
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See HJeeesseesse 


RETURN 
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-*HAVE TABLE *. 
BOUNDS BEEN .* 
*- EXCEEDED . ® 


*NO 
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* G3 
e 
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» 


Pepi r ie CEP Ear 

* * 

* POINT TO NEXT * 
>e ITEM IN RECORD pia 


* 8 
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ee ee) 
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>¢ WRITE ERROR + 
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SSCA eeseeeses 
s 


¢ 
bd IDRIDENT e 
e ¢ 


Seeeeereeeseeee 
.%, 
B2 *, SPSREE IMC RE SSE See 
Pd Ss e. 4 
«* CONTROL &. NO TURN-ON IDENT : 
*, #-------- >sDATA INDICATOR *----- 
*. INDICATOR. * nd 
*,. 0 4 : * 
*. .8 Seoveesoseesecese 
*YES 


SESSOCIESSHSOSSEOS 
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* POINT TO s 
* BEGINNING OF ¢ 
id CESD s 
¢ 
e 


SOCEHEL SSC eeeeess 
: e 


OINT TO NEXT * 
. LINE OF CESD 


° e “e. cc. 
Seeeeesreceeseces *. . 
SYES 


CoeF2eeee0ee0se8 
*® LOG CONTROL °& 
CARD ERROR 
* MESSAGE * 


COFFS SOH HEHE TEESE 


COC G2IECEOEOEES 
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s RETURN . 
SCovcscesceseses 


SOSH TIES SESE SEES 


s HEWLFLOG GCA2* 
-$-6-6. 6.4. Grey 
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: me MESSAGE : 
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¢ 
POINT TO NEXT ¢ 
ITEM IN TABLE 


aeneee 


; 
seseeceeceereewes 


Sse TJeSssesesess 


* LOG TABLE . 
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POINT T 
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FID 


CND2 
SeeeDSesecesess 
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SCeSeSHUSsesesoses B5 ®, 
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* 
tes. oi Is IT 
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SCOSeeeeeoeeseee 
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ss On’ 
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: ENTRY .¢ 
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*. ON .* 
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ENTRY -* 
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* .¢ 
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bd CESD LINE * 
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. 
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* POINT TO CESD * 
* LINE FOR 1ST * 
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"eo, hs 
* .¢ 
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pei aS epee eee ee EEN, 
v 
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eo? we 
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I TEM oe 
eee “e. fe 
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o e 


SOOTHE KI ECO SEE EONS 
* * 
* POINT TO CESD *° 
¢ LINE FOR NEXT 
: ESDID . 


ROCESS 


e-.. 


EW 


*. 
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* GET CESD LINE ¢ .¢ *, 
* NUMBER FOR .* IS CESD ®, 
oe >* ESDID IN THIS sat endoecte. ITEM MARKED . ¢ 
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* + e. .* 
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| eeese 
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e » 
ees8 


SeseteCTSeeovesese 
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onee- >*ITEM (SAVED BY paciecuandye LOAD MODULE ¢ 
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* F2 ¢ 
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eee 
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* TABLE * bg 
* ° ° e 
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° 

SESE] SORES EBOS * ° 
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: RETURN : : END POINTER : 
SECHHOEE EOE ETES * ° 
CORSO EEO EOROOES 
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*. EXCEEDED .* 
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eeete eeee 
s s s e 
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eeos eeoee 
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2 % SOO SHHRECHHHOOD 
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we cere > 
*. 
Hat PeTTTTTITTTT TT TTT) 
~ ate * ADD INCOMING ¢ 
.*DATA MATCH YES * ESDID(S) TO ¢ 
*: INCOMING DATA: # ~------- >*MATCHED ITEM IN® 
o. e s TABLE e 
i eee PTT TIT it 
*NO 
%, 
33° "48, erTrniTiTitTiri yy 
-% 6, . e 
-* IS IT END *,. YES * ADD INCOMING ©¢ 
*, OF TABLE « &------- ->*ITEM TO END OF ¢ 
‘i Pe 6 TABLE * 
“oe, ye MrrTTTITTT ITT tty 
*NO 


Sense Kev es esoene 
* e 

* POINT TO NEXT * 
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* od 
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OOCCHES Se Ceeeeegee 
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* POINT TO NEXT * 
: ITEM IN TABLE hate 
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OOSFHSSCEHHSHOO HOS 


OooPSebecsegooce 


® LOG TABLE . 
bah ad a 
MESSAGE . 
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* WRITE ERROR ¢ 


* MESSAGE Ad 
* e 
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e oe 
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FROM INPUT 
PROCESSOR 


CCOCAL OO SOD OOOS 
° ° 
: HEWLFSCN : 

Scovovecessoces 


SCN900 -%, SCN10240 .¢, a 
eeeeeDl eoeeoosees B2 e, Ba *, BY 6, seoeeepoeseeesosos 
° ° .4 °, .IS THIS®. .° *. RESET COMMENTS ¢ 
¢SAVE COLUMN 72 * .°°IS THIS A'®. YES °"A CONTIN- ®. YES -°1S THERE A*. YES AND ° 
SET POINTER ¢-------- >*®. CONTINUATION .®-------- >*. UATION OF .e-------- >®; BLANK IN. ,¢-------- >® CONTINUATION * 
“Pi TO COLUMN 1 ¢ $. STATEMENT. : S.- *. COLUMN 72. °° ¢ INDICATORS = 
e e . e e e 6 
COCOSHEOEEOHCOOHHEOSD *, _% *, ,®% Me uO eoeesegeeeoeeeeeees 
*NO *NO | 
ie nn oo008 
->902 © ->*02 ¢ 
* cue Cu 
¢ 6 e e 
eos6 eeeoe 
SCN1000 
SCOSSCHECLTECOSE SHOES aaa SCOSSHECJESCSOSSESES 
*READS CTAL® ° *SET POINTER Pl * 
o_0_¢_0_0_0_6_s_0 °SET POINTER P2 * *TO READ COLUMN ¢ 
*READ QPERATION ¢<-------- «To OPD 1 . ° 16 ° 
*SYM-SBT OPTION ¢ . ° * (CONTINUATION ¢ 
*INDICATOR TO 1 * ‘ * * OF OPERANDS) ¢ 
TERETE TERETE Seeeoeseseeseeseeeseeese Seeseeeeeseeeeeeee 
of .* 
D1’ “8. D3," *, 
® s, Po *, 
.*DID SYMBOL *. NO .*OLD STATUS *. YES 
*, END WITH A .%--- *. ,WAS LEVEL 1 ytone 
*, BLANK . : J 
*. .¢ "e. .4 
s, .* oee6 6, ,®8% eee6 
*YES 202 ° ®NO ° ° 
° Bue * G2 ¢ 
e e e 
ee66 
SCN10100 
SOC OSE] Seooeseees SOCCCE FOCoeeoeess 
e e * e 
. SEARCH ° *SET POINTER P2 * 
* PROCESSOR KEY © * TO OPD 0 Ssauce 
*TABLE FOR MATCH® ° , 
TRE RRR EE RUE ETE ET eeeseoeseeegeeeeee 
.%, SCN10120 
F1 ; COSCO PIONS SEE EERE COoeePieecosecess eveoeruseeecesese NOTE - OPTION 
¢ SAVE ENTRY °* *TURN ON 'OPD 0 ¢ *READS CTA1¢ INDICATOR IS 
.*IS THERE A’ *. YES * POINT OF ° *NEW' INDICATOR, ¢ o_0_0_0_0_0_8_0_6 SET TO 1 
*. MA pelesocese >*PROCESSOR - SET¢-------- >*AND SET 'LEVEL' e-------- >e READ 1ST OPND ® 
‘ i * POINTER P2 TO * INDICATOR TO. * *OR CONTINUATION® 
*, .° ‘ OPD 0 ° * ZERO ° * PARAMETER 
Ty obs SoCo CoeeVeseoeees OOSCCH OSHS OSE SOESOHS CHOC OSHHCHEHSEOOSSE 
ies oode oees¢ ese8 ooee 
->e02 6 ° e e01 ° e * 
* BY e * G2 e * Gu e-> °¢ G5 8 
e e Sane e e * oe. 
eeee eves ees coos 
.f, SCN10180 .%, SCN10130_ .*. SCN10200_ .¢, 
Gi *, Sees G2eeeeserees G3 *, G4 G5 - 
.° * ° ° .* ENDED *, .*WAS AT °. .¢ *. 
* SET 'LEVEL’ °® YES .° BY A LEFT ©. YES .*° LEAST ONE ©, NO .*ENDED BY A ®. 
alr IDENTIFY CARD! *< Sepicasks * INDICATOR TO °%<-------- - ,PARENTHESIS | 5 6<s--505-— *: ALID ve __-*. BLANK 1 
f ° ONE +. CHARA ER. ¢ ; .* 
oo ® ® “e, .- « READ o* %, -* 
ese8 “eo. 8 OOSCS SCC ECHHEO HOH EEEE *, .% *, .¢ eoeee s, ® 
° . YES ° *ho #02 ° oYES 
e R2 e eoe6 | eeee e Bue 
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eoce 6 H2 s-. * kK} 6 r 
Cf e e e 
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° ° * ° .* ENDED ¢, .*IS OLD’ *¢, 
: TURN ON * SET POINTER P2 ° * SET 'OPDO °* YES .*°BY'A LEFT’ ®, ¢*._ STA , 
¢__ SPECIAL ° -->*® TO OPD 1 ° ° ABSENT’ ecssculce e. PARENTHESIS .¢ ---0f ENDED BYA .¢ 
*STRING’ OPTION © [ ° * INDICATOR °¢ .° | °. < 
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* DURING SCAN, ¢ *ACCUMULATE SEG * 
* COMPUTE FINAL * * LENGTH AND *¢ 
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-~--~>* EXECUTABLE ON * 


gLet OPTION ONLY ® 
SHOCK SESH SEES SEES 


J2+esesesees 


° 
T MARKED CESD¢ 
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ALIAS 


6 
_-->eS¥NBOL EN LIAS® 
° TABLE - 


ENTOO2Z00 .%. 
G3 * 
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*, 


OOOH JOCH HOH OED 
* USING ESDID ¢ 
*FROM END CARD, * 
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* IN END CARD * 
POKES SHES EE SE DEES 


eens 
02 6 
* A5* 
*¢ 


ENTO1250 
Stese EL Seseseseese 
*SCAN CESD FOR A® 
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"e, 2 
*, ,# 
*¥ES 
o*, o*, 
pan _Fa ee 
YES .eis HIAR BIT. .-*IS PROGRAM *, YES 
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+. .¢ : .¢ 
*, ~* +, * 
*, .# *, .*# 
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* * .* * 
* BUILD SCATTER * YES 


.-*IS PROGRAM *, 
TO BE SCATTER. * 
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LAST . ¢ THIS * 


« RLD 
~~~ *.+RECORD*S TYPE. ¢--— 
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seosHleteooeeseses 


* * 
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*c1e 
. 
ees 


UNRES -*, 
A5 *, 
~* e, 
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CORSO EL Sees eeneee SOeeeK 2 OCC RHEE ED 
* PERFORM * *TYPE IS BRANCH * 
*RELOCATION: ADD® * OR PR TYPE 1 * 
* Or SUBTRACT * * INSERT ABSOLUTE* 
* RELOC. FACTOR ¢ *HEL. FACTOR FOR* 
* * *VALUE OF ADCON * 
LER ER SEER REESE RT SE LPo RRR REE RE ER ELSA SE fF 
CoS eae ee eee DA OS ee le ee Re ee eee eee 
RELOC100 Vv 
POnOerlL eeseseseoe 
* . 
*MOVE RELOCATED * 
*ADCON BACK INTO 
7 TEXT RECORD id 
SOOC OHS E SESE EOE He 
seen 
02 * 
* Gl *-> 
* ry 
oon 
SOSH EGL OOOO FEHR Oe 
td 
* RELOCATE * 
* ADDRESS FIELD * 
* OF RLD ITEM . 
e 
COREE ECO ES OOS 
o*%, 
H1 *, POOSHH I Ove eeeeses 
.* oe. 2 * 
-* *. YES * SAVE RLD ITEM * 
*, SPLIT ADCON .* -e------ 7eIN HESD PREFIX : 
+, e 
6, + . * 
*. ,* SeOCHH OH SE HTETO OS 
*NO 
een 
*02 6 
* J1 *-> 
¢ * Ree eee ee a oe nn ee ee == 
onee 
RELOC120 


OCHO TL HOHE OEE OOES 


. * 
*UPDATE TO NEXT * 
° RLD ITEM bg 
e » 
* s 
SOK SSSEOSOSESES 
soe 
->*01 ¢ 
* p2 64 
° * 
e008 
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CHART FE. RELOCATION ROUTI (HEWLFRE (PART 3 OF 3) 


SCDOVLY . 
Al 


* 
o 
* 


ie ig ITA “*. NO 

*.V-TYPE ADCON . ¢--- 
7 

e eeeoee 


* 
YES *02 © 


° 
* Ale 
* + 
* 
rs 


Bl *, Se eee He eeeeeeene 
_e +, * ERROR + 
.-*1S ADCON'S *, NO o_0_#_#_¢_0_¢_0_¢ 
. LENGTH FOUR .*-------- >*SET BIT MAP TO #--- 

*, BYTES .¢ *REFLECT INVALID* 
+, .* * V-TYPE * 

* ,.* SSeeeeeseseseeeseeseeease 

*YES 02 © 

¢* J1* 

e¢ 64 


Vv 
e*. 
ci’ fe, 
.*IS THE *, 
.*” ADCON'S “*. YES 
*: SYMBOL UN- le--- 
* RESOLVED .* i 
*. .¢ Vv 


o, .* eeeee 
*NO *02 4 
* Ale 
ee 
° 


Vv 
eeseeHloosecessss 
° * 
*OBTAIN SEGMENT * 
. NUMBER OF * 
*CALLED SEGMENT : 


SHSSe SRS eSeesseee 


SOSHEEL OS ERE O EE EE 
* * 
*OBTAIN SEGMENT * 
be NUMBER OF * 
PORLLING SEGMENT® 


SHS HSH HHSEEHS 


Vv 
SOSCOP] COSC ESEESE 
* HEWLCPTH * 
e_¢_ O_O O_O _e_e 
* FIND COMMON * 
* SEG, WITH * 
*HIGHEST SEG NO. * 
SHOHSHSSCSSSSHeSSenees 


Vv 
.*, OVLY70 -*, 
Gl *, G3 +. 
.* *, .¢ *, 
-* IS IT AN *. YES YES .*ENTRY LIST *. 
*. UPWARD CALL . *--- ---*, ENTRY FOR .* 
*, .* *. THIS ID .* 
. .¢ e, . 
oe *. .¢ 
e *NO 
° 


oO 
H1 *, H3 *, CCH HES OOO CES ESe 
.¢ . .¢ *, *HEWLFLOG  GCA2¢ oreeHsecocecces 
.* IS IT.A |*. YES -*ENTRY LIST *. YES @-¢_¢_0_0_e_0_¢ 6 * * 
S.DOWNARD: CALL. ¢o2-sPed2eeenss sara sseeeesce= *.. FULL aiertontene > ENTRY LIST — $-------- > RETURN ‘ 
: A ¢ ‘ * 
*, .* . .¢ * * eoeeeeeoreseres 
*. . *, 6 SCHCHH HEHEHE EREEE 


OVLY10 -*, OVLY90 
J1 *, SOeoe TI SOS SEEEEES 
-*IS IT A*, ° 
-* LATERAL *. YES * CREATE NEW 
*, CALL ACROSS . *--- *ENTRY IN ENTRY 
*. REGIONS .* bd LIST 
es e ° 
e. Je Cooeeeeeeeeeenes 
*NO 


o%. 
Ki e, SOSH eK CA SeeeVeee 
.* IS IT *, *CHANGE VALUE OF* 
.* AN *,. YES *V-TYPE ADCON TO* 
. ALLOWABLE . ¢---------~--~.----.---..-..--—.--- >*POINT TO ENTAB ¢ 
*. EXCLUSIVE. ‘ ENTRY * 


* 


e 
SCHOSHHHHHHEOHEEODD 


*NO 


eo008 seen 
*02 © e02 6 
* Ale #¢ Giese 


Program Organization 141 


This document contains restricted materials of IBM. © Copyright IBM Corp. 1972,1983 


LY26-3921-0 
OCESSO 


FROM INTERMEDIATE 


FF 


OUTPUT OR SECOND PASS PROCESSOR 


SCOOCAD OH OOO EROS 
2 


. 
pl HEWLFFNL . 
Soereresesesees 





SeSoeHhUcseseseese 


> 
; DIRECTORY 
Cooerooooseseoes 


' 
' 
( 
. 
wn 
4 
z 
a 
er) 
n 
eecete 


B2 e, SCORIOC CS SOROOES 
«% *, 
- *OVLY OPTION®. YES ® WRITE TTR * 
®, SPECIFIED .¢*-------- > LIST FOR  -— ----- 
om an ® SEGMENTS Ad 
a 2 COCR ORO EEH ESET ES 
*NO 
Wesetaiiscocecceet ce cesteee Ss Se Soon Sot ee 


SOOSOCISSESSOEEEES 


SOSOECI OC SHSOEEES 


SeseeDuseeseecees 
* HEWLFLOG GCA2¢ 
° ¢_e_¢_0_8_¢_¢ 


~~~ 28 LOG ERROR TYPE * 


: AND MESSAGE : 
SCoseseocosecseese 


* PLACE MEMBER °¢ * SET UP C-BYTE ¢ 
¢ NAME IN PDS °¢ ¢ OF DIRECTORY * 
®DIRECTORY FROM ¢-------- >a O Pa 
* NAME CARD OR ° ® BLOCK/SCATTER * 
DEB e ORMAT ° 
SOSeeesesesesesece SSOeSSSseseseeseeeess 
ET It 
TE ATE | 
FNL301A 8, 
seDN2Zseeeses D3 es, 
STOW * .e *, 
* DIREC * . YES 
* WITH ADD OR ¢-------- >*: ANY ERRORS .¢----- 
* REPLACE AS ¢ : 
° DIRE « *, .* 
eesoseeeseosn *, ,# 
ry) 
sees 
. | 
¢ E2 6 
e Oso ee oS ee es ec ee Se ee ene oe eee a a 
eeee vy 
FNL9OOA _.®. 
E2 re SCOCKOE JOC CCoeoece 


.* ANY ALI As’ ¢. YES 


° *MEMBER NAME A 
*:To BE STOWED .¢----~--- > ENTRY POINT, *--~-- 
. , e PUT IN ALIAS ‘ 
e. 18 evccccecccesscece 
*NO 
eee 
° rs 
e F2 ¢ 
e e-> 
oes 
FNLCN .8 
F2. “¢, eoecerzeseseceeee 
.* HAVE *PRINT IMAGE TO ¢ 
TIRIBUTES *. YES ¢ “NOTIFY OF * 
¢: CHANGED SINCE. ¢----~--- NGED ° 
‘. START OF .° ¢ ATTRIBUTES  ¢ 
“se. 8 Seovesessseccooves 
eNO 
eoce 
e Ad ENTRY FROM 
* Gl °¢ HEWLFINP TO 
ir a TERMINATE =‘ | <------------------------ 
coon 
8, FNLCN2 __.®, 
Gi s, G2 se, 
.° eo, 2% ¢, 
.°HAS 17 BEENS. YES .¢° XREF "6, YES 
10 DONE. e----- e: SPECIFIED .¢--- 
: e . "ee. J 
*, .@ *, ,e eece 
eNO eNO ® ® 
* G1 e 
Sicesccece > Ps ° 
eeee 
IEWLCEOI .°. 
OceeeHi sececccece CoesepZeccccceses 
° HEWLF, EBA2*¢ . Hi TP ° # +, 
o_ 84-62 8_e_s ee -0_0_¢.¢_9_¢_0 8 e *, YES 
° oe > GO-TO PRINT *-------- >*LEND OF INPUT .¢--- 
* PRODUCE XREF *¢ ¢ DIAGNOSTIC * *, * 
Py ° Pf TO! 4 ®. .e 
Coossccsecesecces SOCOHESESESESESCS e. .¢ 
eno 
seojZececece SeTIOeeeeEe 
rs e e rs 


* REPOSITION * 

* INTERMEDIAT 

*FILE (SYSUT1) © 
Seeocereese 


Seoeexx2eeseooeoe 
¢ RETURN TO. ° 
¢ INITIALIZER ¢ 
SOC HHHHSSEOOOE 
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e s 
*CLOSE ALL FILES®<-- 


e td 
COOF 0 OSSHSE 


Sanat it SOR 
CONDITION CODE ¢ 


SAEs YP S—- 
s 


: 
S$OSCSHSHHSHESEO OES 


Logic 


4 ‘ a ahve Maan 
RENT OR*. ADs 
REUS °. YES se ae 
a i ATTRIBUTES - corre ~ 
® DI e 
“es. eo e 
e, .e sinpaeetesercanes 
*NO 
@€eseseecee cess oocc ccs sock 
SOSHOFUSCCSSOEEOEE 
* PICK UP_ALIAS ¢ 
E. (EITHER ¢ 
$ DEFINED OR ne tee ad 
eeoessssssooesece 
seGueseeoos 
*STOW ALIAS *¢ 
* IN e 
* PARTITIONED * 
* DATA SET ad 
e RY © 
eesessesece 
o*. 
HS e, 000009 50 Ceoeoeecose 
.* ¢. ° GCha¢ 
* °, YES 6.6.8. 6.6 .0.8_8 
*. ANY ERRORS . ®-------- 7 8 ne ee ® 
e, 2 e Ee 
s, oe ® ® 
« «® Seesosooooooooesse 
eNO 
ecce 
eFr2 e 
e ® 
eese 
FNLIO6A 
ceseersencereoses 
TO PRI 
cathe aake elras 
Be cone cae 
coos 
->* ® 
«£2 °¢ 
e 
ooee 


eeceRseooesoocee 

e ‘Fo ¢ 
Ssseeeescoce se sosesescice ~—-=->® e 
e e 
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ART GB. 


FROM BSAM 
COCA] OO ESOS ERe 
° ° 
° HEWLCRO1 *-------- > 
° ® 


O40 0K1 O60 06 C008 
bd RETURN TO bd 
: MAP/ XKREF 


COFFCOH SCORE HSOESD 


D ROUTIN 


-* IS THIS °, 
ee E ROM SYSPRINT. ¢ 


FROM BPAM 


COO OC2ES SS COOEe 
* 
HEWLCRC2 * 
* 
OOOO FOO OOOO 


FROM XDAP 


SHOOHEZD OOO Fb EEEE 
* 
HEWLC RO 3 ; 


SOSH SHSSOSEEES 


OOOOH FIERO CHEE ES 
bd INSERT * 
¢ ‘TEWO630' IN ®& 
MSG, SET BIT IN® 
*APT FOR BIT MAP®* 
¢ PROCESSOR be 
SOHC H OOOO OOS OOOES 


eee ee ee 


OOOOHK2IOC EEE OE OES 
* TURN OFF BIT * 
¢ INDICATING ° 
e ERROR WHILE ¢ 
¢ READING SYSLMOD* 
COSCO OL ESES OOS 


HEWLCRO 


° ° 


AR, Aa” *e, AS 8, 
.*IS THIS®, .¢ *, .¢ ‘ 
NO .*FROM SYSLIN®, YES .* IS IT °*, YES .*IS IT VALID*. YES 
wewoesGe >*, OR SYSLIB & le-------->e) INCORRECT | ¢-------->*, SHORT BLOCK . ¢--- 
*. FIXED .¢ *, LENGTH .° *. .¢ 
*. -* *, * *, . 
*. ,* *, .* . 
*No *NO ¢NO 
€ ‘sec SS “si, “Salis me i "i-inr aes tT gs ew ee Pe 
SCeese Hee eesee eee 
6 e seeeenseceeeeees 
® SYNADAF MACRO ® ° 
* ~ FOR BSAM * ¢ RETURN e<-- 
° e 
e e $6666 66660666086 
COOH EHEHEHHOH EHH 
| eo66 
->e ° 
°e F3 6 
e e 
eee 
SeoeeeCzJeeeeeeeeese 
e e 
* SYNADAF MACRO ® 
hid Peis >¢ ~ FOR BPAM * 
e * 
6 s 
SOOO OEH CESSES S 
-*, 
D3 *, PYTTTITL STITT TTY! 
.¢ e, e SET BIT ‘ 
NO .*ENTRY FROM *. YES *¢ INDICATING ¢ 
ee MAP i eee >¢ ERROR WHILE ®* 
o. a eREADING SYSLMOD* 
eons “el ie PPrTTTT TT aTT Titty. 
e e » 
* FR ¢ 
a s 
eo66 
SCOSCCOE JT OCC CEE EE OE 
6 e 
* SYNADAF MACRO ® 
Settle Sie >* FOR EXCP e 
6 e 
e ° 
[TRE RR RRR EES 
eeo8 
e e 
° FR ° | 
° S25 | xese cp Setosecae cece ess 
eoee 


MESGPNTA  .*. 
F3 oeeeFuceereceese 


*. ° INSERT ° 

YES .* ERROR e, NO ¢ "IEWO294" IN ® 
<-------- *. READING « O-------- >eMSG, SET BIT IN® 
*, SYSLMOD .* APT FOR BIT MAP? 

Py ry e PROCESSOR *¢ 


SOe8eG eee KeCeeee 


e ° 
*MOVE MESSAGE TO® 
: PRINT BUFFER : 


e td 
666666465 OS 68664 E8 


COOK OHIeseoseeeooe 


* HEWLEPNT ° 
$60 _¢_0_0_¢_6_6 
. ° 


. PRINT MESSAGE 4 
CORSO REESE FESS 


SCOSSHTIOASOC SOS EOHS 


o e 
e s 
¢SYNADRLS MACRO ¢ 
e e 
TEPER REET 
eoee 
e » 
* KY @ 
e o.- 
eeee 
o%, 
K3, ¢, 
SOCOKHESC COCO OEOE 
YES .* ERROR . NO ¢ EXIT TO FINAL * 
eee eae READING .¢-------->¢ © TO ABORT * 
*, SYSLMOD .* ° 
a é 9666666668866 66 
e, .@ 
s 
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H G R LOGGI 0 


COC AZ ECHO EHEHD 
5 


. 
bd HEWLFLOG ° 
° * 


LPP RRP RE REESE EEE | 


OOOOH DZ O00 Co eOe8 
* * 
*SEPARATE ERROR * 
° CODE AND bd 


sMESSAGE NUMBER . 


OCCT EOE HHODOEED 


LOG03 LOGOT 1%. 
OOOC 1S Oeeeseores c2 *, 
® +, 
* WRITE OUT » YES .* CONTROL *. 
CARD IMAGE €-------+ *. STATEMENT TO .* 
bd °. BE LISTED. * 
Ooerereevesseese er a 
eno 
o*, 
D2 ¢, 
OO00L1 COeseeers .° °, 
- . »*CESD SYMBOL*. NO 
* RETURN * *,.TO BE WRITTEN, ®--- 
bd ° *, OUT -* 
SCOOT EO CE SE SD EDD +, .° 
*, .¢ 
*YES 


COSSOE2 94SEC CEEOOE 
° r 


*MOVE SYMBOL TO ® 
g MESSAGE BUFFER : 


o » 
666666066066 60688 


-*. 
F2 *, 


Pad e, 
e*IS THERE A *. NO 
*- SECOND SYMBOL. *--> 
“eo, oe 
, e 
*YES 


9004 G2 000000008 
* 


e 
* MOVE SECOND *¢# 
Ad SYMBOL TO bd 
eMESSAGE BUPFER : 

° 


OOSSSHHOHHHEHOOS 


COH2 OO OS OoEEOE8 


® WRITE OUT bd 
_ MESSAGE BUFFER | 


SOSSSCHHHE SCE HEOSS 


f caqous exesee 


s 
e 
UPDATE bd 
*CONDITION CODE . 
* 
* 


eee0 


COSCHHHEHESHSHSEOSE 


GAG2 a 
COCK evecccoce .¢ "eo. O0eeK eeeeccccs 
. e YES .¢* +, WO sd bd 
¢ HEWLFFNL = ¢<-------- ¢: SEVERITY CODE. ¢-------- >? «RETURN ° 
Seecneccscseces cgi, .o cccececcccccees 
*, .¢ 
° 
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MICROFICHE DIRECTORY 
The microfiche directory, Figure 33, is designed to help you 
find named areas of code in the program listing, which is on 
microfiche. Microfiche cards are filed in alphameric order by 
object module name. If you wish to locate a control section or 
entry point on microfiche, find the name in column one and note 


the associated CSECT name. A description of the control section 
is also given. 


This section also contains a module-CSECT cross-reference table 
(see Figure 34 on page 148). 


APTEND HEWLFROU | See HEWLEPNT 
SYSLIN, SYSPRINT, and 


APTEXLST Label HEWLFROU 
SYSLIB 
APTXLIST Label HEWLFROU Open exit list for HEWLFINT, HEWLFMAP 
SYSLMOD 
APTO00 Entry point HEWLFAPT SYNAD exit routine for 
SYSPRINT 
Entry point HEWLFSIO Routine to check reads HEWLFREL 
on SYSUTIL 
CHECKWRT Entry point HEWLFSIO Routine to check writes HEWLFREL 
on SYSLMOD 
Label HEWLFROU Major name by which HEWLFINT, HEWLFFNL 
SYSLMOD is enqueued 
GETIDMUL Entry point HEWLFSCD Text LOOK AHEAD/READ HEWLFREL 
AHEAD routine 


HEWLCADI Entry point HEWLFADA Routine to make CESD HEWLFENS 
entries for ENTABS 

HEWLCAUT Entry point HEWLFINC Automatic library call HEWLFINP 
processing 


HEWLCDCN HEWLFRCG | Library DECHAIN routine | HEWLFESD 


Open exit list for HEWLFINT, HEWLFINC 





C 


HEWLCDLK Entry point HEWLFINP DELINK routine HEWLFESD, HEWLFRAT 


HEWLCEOD HEWLFINP | END-OF-DATA routine for | HEWLFINC, HEWLFROU 
SYSLIB 


HEWLCEOI HEWLFENL HEWLFROU 


HEWLCE30 Entry point HEWLFESD Return point to avoid HEWLFRCG 
ESD processing 


HEWLCFAB | Entry point | HEWLFFNL HEWLFROU 


HEWLCFNI Entry point HEWLFFNL Immediate termination HEWLFINP, HEWLFROU 
processing 


Figure 33 (Part 1 of 4). Microfiche Directory 
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HEWLFINP | Pointer to include 
Processor 


Entry point HEWLFIDR IDR user data from HEWLFSCN 


HEWLCICA Label 


HEWLCIDR 


IDENTIFY statement 
processor 


HEWLFINP See HEWLFINP HEWLFTXT 


HEWLFFNL> 
HEWLFINT, 





HEWLCINP 
HEWLCMDB 


Entry point 
Label 






HEWLFROU DCB for SYSLMOD 


HEWLFMAP, 
HEWLFOUT, 
HEWLFSIO, HEWLFSYM 


HEWLFROU DCB for SYSPRINT HEWLFAPT, 
HEWLFFNL, HEWLFINT 


HEWLFRCG | COMMON PATH routine HEWLFESD 
HEWLFAPT | DECB for SYSLIB _  ...3 
HEWLFAPT | DECB for SYSLIN A 


HEWLFESD ESD ID of item HEWLFRCG 
currently in process 


HEWLFROU END-OF-DATA routine for HEWLFINC 
SYSUT1; SYNAD routine 
for SYSUT1, SYSPRINT, 
and SYSLIN 


HEWLFROU END-OF-DATA routine for HEWLFINC 
SYSLMOD 


HEWLFROU I70 ERROR routine for HEWLFSIO J 
SLMO 


SY D 
HEWLFROU DCB for SYSLIN HEWLFAPT, 
HEWLFFNL, HEWLFINT 
HEWLFFNL Termination processing HEWLFROU 
after SYNAD exit 
HEWLFESD Type flags for current HEWLFRCG 
ESD item 


HEWL FROU DCB for SYSUT1 HEWLFFNL, 
HEWLFINT, 
HEWLFOUT, 
HEWLFRAT, HEWLFSIO 


HEWLFINP END-OF-DATA routine for HEWLFROU 
SYSLIN 


HEWLFINT 





HEWLCPDB Label 


| HEWLCPTH Entry point 
HEWLCRBB Label 
HEWLCRBN Label 


HEWLCRID | Label 


HENLCRO1 Entry point 





HEWLCRO2 Entry point 


HEWLCRO3 Entry point 


HEWLCSDB Label 


HEWLCSNX Entry point 


HEWLCTTY ;| Label 


HEWLCUDB Label 


HEWLEEON Entry point 





HEWLENAM 


Reentry i1nto HEWLFROU, HEWLFFNL 
initialization for 
multiple link-edits 


Entry point 





HEWLEPNT Entry point HEWLFROU SYSPRINT OUTPUT routine HEWLFBTP, 
HEWLFFNL, 
HEWLFINT, 
HEWLFMAP, HEWLFOPT | 
HEWLERDM Entry point HEWLFINP PRIMARY INPUT READ HEWLFTXT 
routine 
Figure 33 (Part 2 of 4). Microfiche Directory ) 
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Type 
CSECT 


HEWLFADA Address assignment 

HEWLFROU TABLE ALLOCATION 
routine 

HEWLFAPT All Purpose Table 
CCommunications Area) 

HEWL FMAP RECOVERY routine after 
SYNAD exit 


HEWLFDEF Default size values 


HEWLFENS ENTAB size 
determination 

HEWLFENT Entry statement 
processing 


HEWLFESD ESD record processing 


HEWLFFNL 


HEWLFADA 


C 


HEWLFALK Entry point 


HEWLFAPT CSECT 


HEWLFAPX Entry point 


HEWLFBTP 
HEWLFDEF 


CSECT 
CSECT 


HEWLFEND 
HEWLFENS 


CSECT 


CSECT 
HEWLFENT CSECT 


HEWLFESD 
HEWLFFNL 


CSECT 
CSECT 


Final processing 


HEWLFIDR 
HEWLFINC 


CSECT 
CSECT 


HEWLFIDR IDR record processing 


HEWLFINC Include statement 
processing 


HEWLFINT Initialization 
HEWLFROU DCB for SYSLIB 


HEWL FROU ERROR LOGGING routine 


HEWL FMAP MAP/CROSS-REFERENCE 
processing 


HEWLFOUT Intermediate output 


HEWLFRAT RLD record processing 
HEWLFRCG REPLACE/CHANGE 
statement processing 


HEWLFREL Relocation/second pass 


initialization 


C 


HEWLFINP CSECT 


HEWLFINT 
HEWLFLDB 


CSECT 
Label 


HEWLFLOG 
HEWL FMAP 


Entry point 
CSECT 


HEWLFOPT 
HEWLFOUT 
HEWLFRAT 


CSECT 
CSECT 
CSECT 


HEWLFRCG CSECT 


HEWLFREL CSECT 


HEWLFROU CSECT HEWLFROU Miscellaneous 


routines/LOAD module 
entry point 





( Figure 33 (Part 3 of 4). Microfiche Directory 


Referenced By 


HEWLFINC, 
HEWLFINP, HEWLFROU 


HEWLFAPT 


HEWLFINT 


HEWLFROU 


HEWLFFNL 


HEWLFINT, 
HEWLFOPT, HEWLFOUT 


HEWLFINC, HEWLFINP 
HEWLFADA 


HEWLFADA 


HEWLFINP 
HEWLFOUT, 
HEWLFROU, 
HEWLFSCD, HEWLFADA 
HEWLFINP 


HEWLFINP, HEWLFSCN 





HEWLFINC, 
HEWLFINT, HEWLFROU 


HEWLFROU 


HEWLFAPT, 
HEWLFFNL. 


HEWLFINC, HEWLFADA 
HEWLFAPT 





HEWLFFNL, 
HEWLFOUT, HEWLFROU 


HEWLFINT 
HEWLFADA 


HEWLFINC, 
HEWLFINP, HEWLFSCN 


HEWLFESD 


HEWLFSCD 
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HEWLFSCD Second pass (CLOAD HEWLFOUT, HEWLFROU 
module) output 

HEWLFSCN Control statement HEWLFINP 
processing 

HEWLFSCD Second pass HEWLFSCD 
input/output 


HEWLFSYM SYM record processing HEWLFSYM 
HEWLFRAT TXT record processing HEWLFRAT 
HEWLFROU DCB for SYSTERM HEWLFFNL, HEWLFINT 


HEWLFINT Open exit routine for HEWLFROU 
SYSLMOD 

HEWLFROU Member and alias name | HEWLFFNL, HEWLFSCN 
validity check routine 

HEWLFROU DDNAME for primary HEWLFINT, HEWLFSCN 
input data set 

HEWLFREL Input RLD control block HEWLFSCD 
#1 

HEWLFREL Input RLD control block HEWLFSCD 
#2 


HEWLFMAP JFCB for SYSLMOD HEWLFFNL 
HEWLFINT Address of storage 
obtained from GETMAIN 
HEWLFROU Minor name by which HEWLFFNL, HEWLFINT 
SYSMOD is enqueued 
HEWLFINT Pointer to Coptional) HEWLFROU 
heading message 
HEWLFREL Output RLD control HEWLFSCD 
block #1 
HEWLFREL Output RLD control HEWLFSCD 
block #2 
HEWLFREL Output RLD control HEWLFSCD 
block #3 
HEWLFREL Address constant HEWLFSCD 
relocation routine 
HEWLFREL Routine to create HEWLFSCD 
ENTABS and ENTAB RLDs 
HEWLFADA Pointer to Segment HEWLFOUT 
Length Table 


HEWLFSIO Routine to write CTL or HEWLFREL 


Symbol Type 


HEWLFSCD CSECT 


HEWLFSCN CSECT 


HEWLFSIO CSECT 


HEWLFSYM 
HEWLFTXT 
HEWL TMDB 
HEWLXIT2 


CSECT 
CSECT 
Label 


Entry point 


HEWVLDCK Entry point 


INDDNAME Label 


INRLDCB1 Label 


INRLDCB2 Label 


Label 
Label 


JFCBADDR 


MAINGOT 
Label 
MSGFOUR Label 
OTRLDCB1 Label 


OTRLDCB2 Label 


OTRLDCB3 Label 


RELOCATE Entry point 


SCDENTAB Entry point 
SEGLNTAB | Label 


WRTCRRLD Entry point 


CTL/RLD records on 
SYSLMOD 


HEWLFSIO Routine to write text HEWLFREL 
records on SYSLMOD 


Figure 33 (Part 4 of 4). Microfiche Directory 





WRITXT Entry point 
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Module Name CSECT Name 




















HEWLFADA HEWLFADA 
HEWLFAPT HEWLFAPT 
HEWLFBTP HEWLFBTP 
HEWL FDEF HEWLFDEF 






HEWLFEND HEWLFEND 
HEWLFENS HEWLFENS 
HEWLFENT HEWLFENT 


HEWLFESD HEWLFESD 
HEWL FFNL HEWLFFNL 
HEWLFIDR HEWLFIDR 
HEWLFINC HEWLFINC 



















































HEWLFINP HEWLFINP 
HEWLFOPT HEWLFOPT 
HEWLFMAP HEWL FMAP 
HEWL FINT HEWLFINT 
HEWLFOUT HEWLFOUT 
HEWLFRAT HEWLFRAT, HEWLFTXT 
HEWLFRCG HEWLFRCG 


HEWLFREL HEWLFREL 








HEWLFROU HEWLFROU 
HEWLFSCD HEWLFSCD, HEWLFSIO 
HEWLFSCN HEWLFSCN 


HEWLFSYM HEWLFSYM 


Figure 34. Module/CSECT Cross-Reference Tabla 
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TABLE LAYOUTS 


This section provides detailed layouts of internal tables used 
during Linkage Editor processing. Figure 35 indicates the 
modules in which tables are initialized and used or modified. 
Tables described in this section are included alphabetically 
except for the All-Purpose Table (see Figure 36 on page 151). 


1972,1983 


Composite External Symbol HEWLFESD HEWLFRAT, HEWLFSCN, HEWLFINC, 
Dictionary (CCESD) HEWLFADA, HEWLFENS, HEWLFENT, 





HEWLFOUT, HEWLFTXT 


HEWLFESD HEWLFRAT, HEWLFSCD 


HEWLFENS 





Delink Table 
Downward Calls List 


Entry Table CENTAB) HEWLFSCD 





Half ESD CHESD) 


IDR IMASPZAP Table CIDRZPTAB) HEWLFIDR HEWL FOUT 
IDR User Data Table CIDRUDTAB) HEWLFIDR HEWL FOUT 
ORDER Table HEWLFSCN HEWLFOUT, HEWLFADA 


Relocation Constant Table (RCT) HEWLFADA HEWLFOUT, HEWLFSCD 


Renumbering Table CRNT) HEWLFESD HEWLFRAT, HEWLFTXT 


RLD Input Control Blocks 


RLD Note List HEWL FRAT 
Text I/0 Table HEWLFTXT 


Text Note List HEWLFTXT HEWLFOUT, HEWLFSCD 


TTR List (Text I70 Control HEWLFSCD HEWLFSCD 
Table) 








Figure 35. Table Construction and Usage 
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Notes to Figure 35: 


1 Major communications area throughout linkage editor 
processing. 


2 Built and processed entirely within one routine. 


ength ease | Description 


PDSEl Member or alias name of module being created 


Relative disk address (TTR) of first record 
of module 


offset 
Decimal 


r 


— 
on 


| an 
a | w 


Bit 0 Alias indicator 
Bits 1-2 Number of TTRs in user data 
Bits 3-7 Length of user data in half words 


Relative disk address (TTR) of first text 
record of module 


Relative disk address (TTR) of note list or 
scatter/translation record 


NO 


1 Number of TTRsS in note list, if present 
Flags (module attributes #1) 


Bit 0 Reenterable 


Lo Bit 1 Reusable 


PDSE? 


Bit 2 Overlay 
Bit 3 Test 
Bit 4 Only loadable 


Bit 5 Block/scatter format 


Bit 6 Executable 


Bit 7 Module contains 1 text record and no 
RLD‘'s 


1 PDSE8& Flags (module attributes &l) 


, Bit O Output load module not downward 
compatible 


Bit 1 Origin of first text record is zero 


Bit 2 Entry point assigned by linkage 
editor is 


ee Bit 3 Module contains no RLD items 


Bit 4 Module can be reprocessed by linkage 
editor 


Bit 5 Module does not contain SYM records 


= — 
i Ww oS 


Bit 6 Module was created by link editor F 


( Figure 36 (Part 1 of 10). All-Purpose Table CAPT) 
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Offset 
Decimal 


Description 





Bit 7 Refreshable 


Total contiguous storage requirement for load 
module 


Bit 0 Load module built by OS/VS linkage 
editor 


Bit 1 Not used 


Bit 2 Page alignment required for load 
module 


Bit 3 SSI present in directory entry 


Bit 4 Directory entry contains 
authorization code 


the first text record 


PDSE16 ESDID of the control section containing the 
entry point 


Figure 36 (Part 2 of 10). All-Purpose Table (CAPT) 


N 
— 


& 
i) 


Se ee ee 
“}] Ul] WG 


Ps) 
Yo] 
W 
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i 
N 


es) 
— 
N N 
* TI ~~ 


~J 
NM 


Ce 


188 
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a [oe z 
Decimal Length Description 
a Bit 4 LOG 

Bit 5 XCAL 
Bit 6 TXT/RLD 


Bit 7 A library statement was read 


189 APT1 Flags 


Bit 0 More include input to come 


Bit 1 Automatic library call in operation 
Bit 2 Object or load module 

Bit 3 Delete indicator 

Bit 4 Entry point received 

Bit 5 Symbolic or absolute entry 

Bit 6 Entry statement received 

Bit 7 ESD write indicator 

9 APT2 Flags 

Bit 0 No length received 
Bit 1 No length indication 
Bit 2 First text record 


Bit 3 Status indicator received 


Bit 4 Include previously initiated 
Bit 5 I/0 overlap bit 





= 
So 





Bit 6 In module indicator 


Bit 7 Card continuation 


191 APT3 Flags 


Bit 0 End of file 


Bit 1 Name statement received-end of input 
for load module 


Bit 2 End of SYSLIN input 


Bit 3 To stow as replacement 


Bit 4 First text of load module 
Bit 5 First text of segment 

Bit 6 RLDs for group 

Bit 7 SYSLIB opened 


192 4 CTIR Relative disk address (TTR) of first CESD 
record, if MAP or SREF option specified 


( Figure 36 (Part 3 of 10). All-Purpose Table CAPT) 
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| Description 


resno | current sesnent number 
Taxz [ov [+ | rece | Adsrass of replace/change chain bepianing 
rane [ose [ates [address of attes cain beginning 
a 
[ass fee [owt | vasrase of 810 cote Hist 2 
aso [re [+ | eupinPan| Address of RLD input butfery tet penn 


Ses eee | Address of Relocation Constant Table - 4/ 
Renumbering Table - 4 
} 2480 | F8 | @ | CTXTIO Address of Text I/0 Table 

rasa [ re [+ | aias | address of Alias Tobe 
ass [100 «| Dix | Address of DELING Table 3 
[eat [aoe [es | es aarene or coments soe] 
[ase [08 [+ | setst | aadrass of second pass entry iat 

Fase [aoc |_| ruse | Address of toxt note Hist? 

rere [aio |_| entse | address of RUD note ist @ 

reso [aa | « | RUDOUTDF| address of cutout RID butfery @nd pasa 

ese | az0 | | oRDrane | address of Order Table 

[ase | a2 [+ | aNoaRcrr| Address of breaking point in include chein 

rave | aze |_| ererinci| Address of currently included ESD item 

sea | aze [2 | enmex | Maximum number of entries in RWT Table 

[soz | a2e | 2 | encox | Maximum number of entries in /HESD Tablea 

see [ase [2 | eWrax | maximum number of entries in toxt note 1ist 1 

30s [ase [2 | eneix | rloximun number of entries in RLD note Tat 1 
sos [ase | 2 | ewrax | maximum number of entries in text note List 2 


Figure 36 (Part 4 of 10). All-Purpose Table CAPT) 


Offset 
Decimal 


aortas 


NO 
Lo | 
Ps) 


Se a 


ai 


— 


FT 


Ta] 


es) 


2) 
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Offset 
Decimal 
C 


314 | 13a | 
316 | 13¢— 
318 | 13E- 
144 


| 144 


56 
ras 


Description 
| Maximum number of entries in RLD note list 2 
ENTOX 
ENCLX 
| ENDTX 
ENS1X 


BUFSIZ 


Maximum number of bytes in Text I/0 Table 


Maximum number of bytes in calls list 


Maximum number of entries in DELINK Table 





Maximum number of segments 





Size of load module input buffer 


Address of HESD Table - 8 


ENELTX Maximum number of entries in 2nd pass entry 
list 

ENT1IX1 Maximum number of entries in text note list 
1, pre-reallocate 

ENR1X1 Maximum number of entries in RLD note list 1, 
pre-reallocate 


IDRTRLEN;| Maximum length of IDR Translator Data Table | 
IDRTILEN| Maximum length of IDR Translator ID Table 
IDRUDLEN| Maximum length of IDR User Data Table 


IDRZPLEN| Maximum length of IDR AMASPZAP Data Table 






Ww 
ws) 
So 


IDRTRTAB! Starting address of IDR Translator Data Table 


IDRTITAB| Starting address of IDR Translator ID Table 
IDRUDTAB| Starting address of IDR User Data Table 
IDRZPTAB| Starting address of IDR AMASPZAP Data Table 


IDRTREND| Address of next available byte in IDR 
Translator Data Table 

IDRTIEND| Address of next available byte in IDR 
Translator ID Table 

IDRTIEND| Address of next available byte in IDR 
Translator ID Table 

IDRUDEND| Address of next available byte in IDR User 
Data Table 

IDRZPEND| Address of next available byte in IDR 
AMASPZAP Data Table 

ENRLD2X Maximum size of input RLD buffer, Ist pass 

LSTS Last segment in each region Cregion 1-4) 

Entry point symbol or end card address/symbol 


ENTIC Current number of entries in text note list 1 
ENR1C Current number of entries in RLD note list l 


( Figure 36 (Part 5 of 10). All-Purpose Table CAPT) 


160 


168 


4 


rise 
rie 


17A 


4 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
riao 


A 
C 
8 
A 
C 
0 
2 
4 
& 
C 
C 
0 
4 
8 


3 
3 
4 
4 
4 
5 
5 
5 
5 
6 
16 
17 
17 
18 


324 
334 
344 
364 
364 
372 
376 
378 
384 
394 


4 
4 
4 


ui 
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ERE [ow [are [mer [om 

Decimal Length Description 

} 396 | isc | 2 (| enttc | Current number of bytes in TXT I/0 CNTL Table 
) 398 | se | 2 | ENIRC Current number of bytes in RLD I/O CNTL Table 
) 400 =| 190 | 2 | ENToc Current number of bytes in TXT I40 Table 

| 402 | asa} 2 | ENcLe Current number of bytes in calls list 

} 404 = | 194 | 2 | ENS1¢ Current number of entries in SEGTABI 


414 19E ENELTC 


cu 


Current number of entries in Alias Table 
Current number of entries in DELINK Table 
Current number of entries in RNT Table 

Current number of entries in H/CESD Table 


Current number of entries in 2nd pass entry 
list 


} 416 = | aan | 2 ENT2C Current number of entries in TXT note list 2 
)4ig | uaz 2 ENR2C Cirrent numberof entries in RLD note dist 2 
} 420 | ane | 2 ENSPC Highest segment number with text 


424 1A8 IDRTRCUR| Current number of bytes in IDR Translator 
Data Table 

428 1AC IDRTICUR| Current number of bytes in IDR Translator ID 
Table 

432 1B0 IDRUDCUR]| Current number of bytes in IDR User Data ; 
Table 

436 184 IDRZPCUR| Current number of bytes in IDR AMASPZAP Data 
Table 

rose fee 


ORDRCUR | Current number of bytes in Order Table 


440 ORDRMAX Maximum number of bytes in Order Table 


444 1BC BITMAP Bit switches denoting error messages logged 
Cerror msgs 64-1) 
452 104 BITMAP2 Bit switches denoting error messages logged 
Cerror msgs 128-65) 
icc LINECNT Number of lines output for current page 


462 HISEV 


SYSRTN 


Highest severity message logged 


— 
oO 
m 


oe ee ee ee ee ee oe 0s 
ND 


1D0 Save area for registers 13 and 14 from 


INVOKER 


= 
Oo 
oe 


SPACES 
ERDIG 
ERDIGA 


Register save area 
Address of HEWLFLOG, error logging routine 
Address of HEWLFALK, table allocation routine 


System status indicator (Cfor APT) 


Le 
on 


wn Ory ui] & = 
ee ee ee oO 
Co | & | MO = 

NO NO 
fh 

oO & 


NO 


FFCADR Highest address retained from gotten storage 


Figure 36 (Part 6 of 10). All-Purpose Table (CAPT) 
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Eo ed ed ee 
Decimal Length Description 
C /560 | 230 | 8 ‘| LIBNAME Name of library for automatic library call 
568 | 238 | 8 ‘| LIBOPEN. Name of library currently open 

/2 | aprooo — SYNAD routine for SYSPRINT data set 

}3 | savaTs | Attributes save area 

| fs Bat 0 TS0 task 

| dT Bit 1 Not used 
ie nsotuterretocetanie 
ie sans everrice 
a a 
[aie 5 tinkace esitor neat received 
a YC 
a 
rez [es [a [new [ries SSCS 
TT didnt oar oft indicates tnt tine in IT 
ne ae ae Bit 1 MAP/XREF entered from 

intermediate/final processor 
CF aie a tbe i sterasernot in storaoe 
|__| art MaPrxneF in control/not in control 


el ee 
r £ tO UCU Bit 4 Normal printing on SYSPRINT/ABORT 
without printing 

po SER ARCHY 
BG Not sed 
pT Bit 7 Indicates purse to TXT/RLD processor 
ses | 267 | a | News? | Flags 
pT Bi 0 More RiDs exist for current 1D 
po Tt Seti RLD in output butter 


Bit 2 R and P pointer have been saved 


Bit 3 Relative/absolute relocation factor 
needed 

Bit 4 Split RLD has been saved in HESD 
prefix 

Bit 5 No RLDs exist for last text of 
segment/module 

Bit 6 Split RLD is preceded by R and P 
pointers 


( Figure 36 (Part 7 of 10). All-Purpose Table (APT) 
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Offset 


Decimal Length Description 


Bit 7 R and P pointers for current chain 
are in buffer 


584 


RQ 
Bs) 
Go 


APTSW2 Flags 

Bit 0 SYSLMOD Bhudeued 
Bit 1 Not used 

Bit 2 SYSLMOD shared DASD 


Bit 3 First/not first time through 
initialization 


Bits 4-7 Not used 





249 APTSW3 
Bit 0 Expand statement encountered 
Bit 1 Included load module was in overlay 
format 


Bits 2-7 Reserved 





249A 
587 24B 


APTSWS4 Switches 





Flags 
Bits 0-2 Not used 





Bit 3 Last IDR item processed not complete 


Bit 4 Double IDR entry on object module 
record in process 


Bit 5 Identify control card in process 


Bit 6 Object module end card in process 
for IDR input 





Bit 7 Load module IDR in process 


1S) 
oo 


MN 
ms) 


m 


APT4 


| Flags 

Bit 0 Tables initially allocated 
Bit 1 Tables reallocated 

Bit 2 Intermediate pass processing 
Bit 3 Second pass processing 


| Bit 4 Ordering required 


Bit 5 Page boundary alignment required 
Bit 6 Align on 2K-byte page Boundary 
Bit ? Not used 

24 MAXBF 


HEWLCRBB 


Maximum blocking factor 


SYSLIB control block 


Figure 36 (Part 8 of 10). All-Purpose Table CAPT) 
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Offset 
Decimal 


Length Description 
Address of SYSLIB DECB 
lst library buffer 
2nd library buffer 
BLKSIZE 
LRECL 


BLKFCTR 


—] 
oe 


Number of records left in buffer 


264 Address of current record 
READSW set to first read 
SYSLIN control block 
Address of SYSLIN DECB 
lst SYSLIN buffer 
2nd SYSLIN buffer 
BLKSIZE 
LRECL 


BLKFCTR 


HEWLCRBN 


Number of records left in buffer 
Address of current record 
READSW set to first read 
HEWLCWBB| SYSPRINT control block 
Address of SYSPRINT DCB 
Ist SYSPRINT buffer 
2nd SYSPRINT buffer 
BLKSIZE 
LRECL 
BLKFCTR 


Number of records left in buffer 


668 Address of current record 
672 WRITESW set to first write 
676 RLDOUTI1 Address of first RLD output buffer, lst pass 


RLDINBF1l 
RLDOUT2 
RLDINBF2 


Address of first RLD input buffer, 2nd pass 


A] O 
~ 
oOo}; a 


8 
680 


Address of second RLD output buffer, Ist pass 


Address of second RLD input buffer, 2nd pass 


( Figure 36 (Part 9 of 10). All-Purpose Table CAPT) 
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ae: | Description 


Address of start of text buffer 
| Address of end of text buffer 
Size of SYSLMOD multiplicity or record 
Size of SYSUT1 record 
Maximum number of bytes per track on SYSUT1 
Size of each input RLD buffer, lst pass 
Size value 1 (maximum allowable storage) 
Size value 2 (load module buffer) 
Pointer to 1st heading message 
Potnter to 2nd heading message 
Pointer to 3rd heading message 
Address of current read block 


DECB for SYSLIN 
DECB for SYSLIB 
COREADR Address of storage obtained through GETMAIN 


Offset 
Decimal 


684 
688 


N 
oO 


A 


Mh 7] BR 
wl oo 
; Co; & 


~ 
NO 
oS 


724 2D4 
728 
732 2DC 

FO 


776 CORELEN Length of storage obtained through GETMAIN 
780 30C 4 BRNCHSV Save area 


APTAPFCT|] Default length of authorization code 
APTAPFAC;] Default authorization code 


PDSAPFCT|] Length of authorization code assigned 


PDSAPFAC| Authorization code assigned 


849 351 
850 
851 


MODEAMOD| Addressing mode from mode control statement 


MODERMOD] Residence mode from mode control statement 


PARMAMOD! Addressing mode from PARM field 


PARMRMOD! Residence mode from PARM field 
MEMBAMOD| Addressing mode for main entry point 
ESDARMOD| Residence mode accumulated from ESDs 


Figure 36 (Part 10 of 10). All-Purpose Table CAPT) 
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Alias Table 


Built by Entry Processor 
Referred to by Final Processor 





CESD entry number = present only if symbol is one that is present in the CESD and is type 
SD or LR. This field contains zero for all other symbols (2 bytes). 


—— Symbol - the eight-character alias name (8 bytes) 


Figure 37. Alias Table 








Calls List 
As built by RLD Processor 


Ga 62 Ga ified 72 Gall a ae, “PL 
7 


2 bytes of binary zeros 








Relocation pointer - points to the referred to symbol in the CESD (types SD, LR, ER, WX, 
and CM) (2 bytes) 
Relocation pointer (2 bytes) 


Relocation pointer (2 bytes) 


Position pointer - points to SD or PC in CESD that contains the references (V-type address constants) (2 bytes) 


Figure 38. Calls List (CAs Built by RLD Processor) 








Calls List 
As altered and used by ENTAB Size Determination Routine (HEWLFENS) 






2 bytes of binary zeros 
(End of chain indicator) 


Chaining value - inserted by HEWLFENS -~ count, in bytes, to next chaining value (2 bytes) 


Figure 39. Calls List CAs Altered and Used by ENTAB Size Determination Routine) 
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Composite External Symbol Dictionary (CESD) - Internal Format 


Built by ESD Processor and Control Statement Processors 
Modified by Address Assignment Processor 


ba SOP So 


Chain pointer/chain ID/length - chain pointer when the entry 
type is: ER-Include w/pointer or an ER-ddname 
that was extracted from a LIBRARY control statement 





chain ID when the entry type is: 


ER-Library (the symbol was extracted from a LIBRARY control statement) 


length of control section for type: 


SD, PC, PR, or CM (2 bytes) 


Subtype - ER 
ER-Control change 


ER-Control replace 
ER-Control delete 


ER-Control include w/ pointer 


ER-Control include w/o pointer 


ER=-ddname 
ER-Alias 
ER-Overlay 


ER-Unmatched library member 
ER-Matched library member 


ER-Unmatched no call 
ER-—Matched no call 
ER-Never call 
ER-Delete 
ER-Replace 

(1 byte) 


If segment number, 1 to 255 (SD, CM. PC, LR) 


If AMODE/RMODE/RSECT data (SD, PC): 
2O0OOK not used 
R RSECT information 
0 = not read-only 
1 = read-only 
R. RMODE data 
0 = 24 
1= ANY 
.AA  AMODE data 
00, 01 = 24 
10 = 31 
11= ANY 


Alignment factor (PR) 
07 = doubleword 
03 = fullword 
01 = halfword 
00 = byte 





-—Type - Section definition (SD) XXX 
oe Label reference (LR) XXXX 
Private code (PC) XXX 
Common (CM) XXXX 
Pseudo register (PR) XXX 
Null 0000 
External reference (ER) XXXX 
Weak external reference (WX) —- XXxx 
(1 byte) 


Symbol - the eight-character symbolic name (8 bytes) 


Figure 40. Composite External Symbol Dictionary (CESD)—Internal Format 


162 MVS/370 Linkage Editor Logic 


0000 
0011 
0100 
0101 
0110 
0111 
0010 
1010 


1111 0000 
1110 0000 
1110 1000 
1101 0000 


1010 0000 


0000 0010 
0000 0011 
0000 0100 
0000 0101 
0000 0110 


0000 0000 


Subclassification - 


Delete xxx] 
Replace xxx | 
Insert = xx1x 
Chain x1xx 
Map 1xxx 


AA 
XXX 
MARX 
XXX 
KKK 


Lo address/reverse chain [ID - used to create a chain of CESD entries (3 bytes) 


1972,1983 
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See Figure 41 for normal combination of internal CESD types. 




















CESD Entry Type Type Field | Chain Address AMODE/RMODE/RSECT ER Subtype ddname Pointer/ 
Chain iD Data or Segment Number Chain ID/Length 
(bytes 9-11) (byte 12) 





(byte 13) (bytes 14-15) 


Length of control section 


(5) 


Alignment Length of pseudo register 
value (1) 


| xxxx 1010 | Hex00 


Section Definition 


Private Code 





xxx 110 










Pseudo Register 


External Reference 





Weak External Reference 
Label Reference 




















[en a 
ee cs 





Delete 


0000 1000 

0000 0010 CESD entry no. of 
next item (ID) 

0000 001) CESD entry no. of 
next item (ID) 


0000 0100 


0000 0101 
0000 0110 


1001 0000 


1010 0000 
1011 0000 Forward chain 
PTR (Library only) 


1100 0000 





ER - Unmatched Lib- 
rary Member Name 





ER - Matched Library 
Member Name 





ER - Never Cail 


ER - Overlay Control 
Statement 





ER - Alias Control 
Statement 


ER - ddname from 0900 0010 
Library or Include Statement 
ER = Include Control 0000 0010 | Address of next 
Statement w/o Pointer item in the chain 
ER = Include Control 0000 0010 | Address of next 
Statement with Pointer item in the chain 
ER = Replace Control 0000 0010 | Address of next 1100 0000 
Statement (3) item in the chain 

0 


brary's ddname 
ER - Control Delete (4) 000 0010 | Address of next 1110 1000 
item in the chain 
ER - Change Control 0000 0010 
Statement (3) 


Figure 41 (Part 1 of 2). Normal Combination of Internal CESD Types 









1101 0000 


Pointer to li- 



















Address of next 
item in the chain 





1111 0000 
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Notes: 
1. Alignment Value -- Specifies boundary alignment of the pseudo register 
00 = byte alignment 
01 = halfword alignment 
03 = fullword alignment 
07 = doubleword alignment 
BLDL has been issued for this member name if bit 64 is set to 1. 
Two CESD entries are made for each Replace or Change control statement, one entry for each symbol . 
This entry results from a Replace or Change control statement that contains only a single symbolic name. 
If segment number, 1 to 255. 
lf AMODE/RMODE/RSECT data: 
MXKK 26. not used 
ae Se RSECT information 
0 = not read-only 
1 = read-only 
sheer RCs RMODE data 
0=24 
1= ANY 
Secon ihe AA AMODE data 
00, 01 = 24 
10 = 31 
11= ANY 
6. If segment number, 1 to 255. 
Otherwise, zero or blank. 


Figure 41 (Part 2 of 2). Normal Combination of Internal CESD Types 


oRwWwn 








Delink Table 


Built by RLD Processor (Delink Routine), 
Referred toby Second Pass Processor, RLD Processor 









a Oe 


Address - assigned to the symbol being deleted (3 bytes) 


CESD entry number (ID) - the relocation pointer of an RLD item referring to the symbol that is 
replacing the identically named symbol (or symbols) to be deleted (2 bytes) 


Figure 42. Delink Table 








Downward Calls List 
Built by and referred to by ENTAB Size Determination Routine (HEWLFENS) 


Segment number - entries are one for one with those of the CESD. Ifa 
downward call is made toa symbol, the segment's number from 
which the call is made is entered in the downward calls list 


at an entry corresponding to the ESDID of the symbol in the 
CESD. The list is initially zero. (1 byte) 


Figure 43. Downward Calls List 
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Entry List 


Built by and referred to by Second Pass Processor 


— 
entry (6 bytes) 






Address - linkage editor assigned address of the 
ENTAB entry for this symbol (3 bytes) 


Segment number - that will contain this ENTAB entry (I byte) 


Half ESD entry number - corresponding to the CESD entry that 
contained the referred to symbol (2 bytes) 


Figure 44. Entry List 








Entry Table (ENTAB) 


Built by Second Pass Processor 








Unconditional branch to last Address of referred "to" seg Previous Caller 

entry-BC 15, DISP (15,0) to symbol number (zero initially) 

Unconditional branch to last Address of referred "to" seg Previous Caller 

entry-BC 15, DISP (15,0) to symbol number (zero initially) 
| | | 

| | | | | 

| 


| | | | 
Unconditional bianch to last Address of referred "to" seg Previous Caller 
entry-8C 15, DISP 15,0) to symbol number (zero initially) 
L 15, 4 (0,15) loads GRI5 with "from" Address of segment 
SVC 45 the value of the adcon Beh ele a table (SEGTAB) 


2 bytes + bytes 2 bytes 2 bytes I byte 3 bytes 


DISP -~- is the displacement, in bytes, of this entry from the last entry. 
"to" segment number ~~ is the number of the segment containing the symbol being referred to. 
"from" segment number -- is the number of the segment that contains this entry table, 











| 


Figure 45. Entry Table CENTAB) 
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Half External Symbol Dictionary 
Built by Intermediate Output Processor 
Referred to by Second Pass Processor ‘ 


one 
entry (8 bytes) 









: Length (3 bytes) 


If segment number, 1 to 255 (SD, CM, PC, LR) 
lf AMODE/RMODE/RSECT data (SD, PC): 
MMMM LL. not used 
.R... RSECT information 
O = not read-only 
1 = read-only 
eae! oe RMODE data 
0 = 24 
1=ANY 
Bath hie ‘AA AMODE data 
00, O01 = 24 
10 = 31 
11 = ANY 


Alignment factor (PR) 
07 = doubleword 
03 = fullword 
01 = halfword 
OO = byte 


Linkage Editor assigned address - of this symbol (absolute value of the address constant) (3 bytes) > 


Indicator-Type - Bit zero is not used. Bits 1, 2 and 3 are used as an indicator field that applies to: 
~— §D,, PC = Bit 1 = 0 -~ this control section (SD or PC) does not have 
the highest CESD entry number with text in this segment 
= | -- this control section (SD or PC) has the 
highest CESD entry number in this seament 
SD, PC, or CM - Bit 2 = 0 -- relative relocation constant is a positive value 
= | -- relative relocation constant is in 
complemented form 
PC-delete - Bit 3 = 1 -- indicates that this unnamed control section 
is a SEGTAB or ENTAB. 


Bits 4, 5, 6 and 7 are used to specify the entry type: 
0000 = Section Definition (SD) 
0010 = External Reference (ER) - all fields are zero except type 
1010 = Weak External Reference (WX) 
0011 = Label Reference (LR) 
0100 = Private Code (PC) 
0101 = Common (CM) 
0110 = Pseudo Register (PR) 
0111 = Null - all fields are zero except type 


Figure 46. Half External Symbol Symbol Dictionary CHESD) 
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High ID Table 


Built and referred to by Intermediate Output Processor 


a i a 


CESD entry number - entries are in segment number order. Each 
entry contains the highest CESD entry number 
(ID) assigned to a section definition (SD or PC) 
within that segment. (2 bytes) 


Note: If segment does not contain text, its corresponding entry contains zero. 


Figure 47. High ID Table CHIID) 
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Virtual Storage Allocation Table 


Indicators (1 byte ) 
Used by Allocation Processor 


Number of current entries 


Minimum Size - minimum number of bytes 
of virtual storage required for 


this table (2 bytes ) 


Weight - The factor used to allocate extra virtual storage 
to enlarge the table. It specifies how many 
bytes will be added to this table for every 582 
bytes (or 603 bytes, with overlay) which become 
available (2 bytes). 


Number of Bytes per Entry - number of bytes per entry for 
this table (1 byte) 


Number of Entries - 156 - a value to which must be added 156 to 
determine the address in the all purpose 
table at which the number of entries value 
for this table is to be stored (1 byte ) 


Address - 156 - a value to which must be added 156 to determine the 
address in the all purpose table at which the determined 
address for this table is to be stored (1 byte) 


Indicators - (1 byte) 


Bit 0 - table needed to process overlay modules only 
Bit 1 - table needed during first pass 

Bit 2 - table needed for intermediate processing 

Bit 3 - table needed during second pass 

Bit 4 - table requires doubleword alignment 

Bit 5 - table requires word alignment 

Bit6- NA 

Bit 7 - table has a zero entry (prefix) 


End Flag - FF (1 Byte) 


Figure 48. Virtual Storage Allocation Table 
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Partitioned Organization Directory Record 
As received from BLDL 


Byte 


Name of load module (member or alias name) ! 


Concatenation 
Relative (to beginning of data set) track address of module (TTR) number 


Byte of binary Alias indicator and Relative (to beginning of data set) 
zeros e miscellaneous info track address of first text record 


Continuation of Byte of binary Relative (to beginning of data set) 
track address Zeros track address of note list or scatter- 


translation record Number of entries Module attributes] (see Figure 50) 
in note list ** 0,1,2,3,4,5,6,7,8,9, 10,11, 12, 13, 14, 15 


Total contiguous quantity of virtual storage requred by the Length (in bytes) of 
module first text record 


Continuation of Module's linkage editor assigned entry point address 
length 


Module Attributes 2 AMODE/RMODE information RLD count 
(see Figure 50) (see Figure 50) 










Length of scatter 
For toad modules in scatter format add: : 















list (in bytes) Length of translation table (in bytes) ESDID (CESD entry 


number of control 










section name) for 
first text record 


ESDID (CESD entry number of control 
section name) containing entry point 


Entry point address 
For load modules with alias names add: 


of the member name 


Member name 





SSI Bytes - Aligned on a halfword boundary at the end of the PDS record 


Legend: 
Alias indicator and miscellaneous information: 
Bit Meaning 
0 0 signifies none 
1 signifies alias 
1,2 number of relative track addresses (TTR) in user data field 
3-7 length of user data field (in halfwords) 
PODS Directory Record Size: 
Format Bytes 
Block 36 (with alias names, it is 46 bytes) 
Scatter 44 (with alias names, it is 54 bytes) 


Note: For SSI, add 4 bytes to sizes given above. 
*This is normally a zero byte inserted to maintain halfword boundaries. If the DCB operand was specified as zero and the name 
was found in the link library, this byte will contain a 1; if the name was found in the job library, this’ byte will contain a 2. 
**This byte contains a zero if load module is not in overlay. 


Figure 49. Partitioned Organization Directory Record CAs Received from BLDL) 
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roe 


Module Attributes 1 


Bit Number Attributes Bit Setting Indication 
0 RENT 0 Not reenterable 
l Reenterable 
1 REUS 0 Not reusable 
1 Reusable 
2 OVLY 0 Not an overlay module 
l Overlay module 
3 TEST 0 Not under test 
1 Under test 
4 LOAD 0 Not only loadable 
1 Only loadable! 
5 Format 0 Block format 
1 Scatter format 
6 Executable 0 Not executable 
1 Executable 
vi Format 0 Module contains more than one text 
record and/or RLD record(s) 
1 Module contains only one text 
record and no RLD record 
8 Compatibility 0 Module can be reprocessed by all 
levels of linkage editor 
1 Module cannot be reprocessed by 
linkage editor E 
9 Format 0 Linkage editor assigned origin of 
first text record is not zero 
1 Linkage editor assigned origin of 
first text record is zero 
10 Format 0 Linkage editor assigned entry 
point is not zero 
1 Linkage editor assigned entry 
point 1s zero 
ll Format 0 Module contains RLD record(s) 
1 Module does not contain an RLD 
record 
12 Editability 0 Module can be reprocessed by 
linkage editor 
1 Module cannot be reprocessed by 
linkage editor 
13 Format 0 Module does not contain TESTRAN 
symbol records 
1 Module contains TESTRAN symbol 
records 
14 Compatibility 1 Module created by linkage editor F 
15 REFR 0 Module is not refreshable 
Note: 


i Module can be loaded only with the LOAD macro instruction. 


in virtual storage, it is entered directly, not through the use of an 


When the module is 
XCTL, 


LINK, or ATTACH macro instruction. 
Figure 50 (Part 1 of 2). Module Attributes 
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Module Attributes 2 


Cc Bit Number Bit Setting Indication 

0 1 Module has been processed by OS/VS linkage editor 

1 0 Reserved ~ Unused 

2 1 Page alignment required for load module 

3 1 SSI present 

4 1 Authorization code present in last 2 bytes of 

directory entry 
AMODE/RMODE Information 
MMM bien Not Used 
| re RMODE for Load Module 

0 = 24 
1 = ANY 

sede Wes Aaa aa the True Alias or Alternate Entry Point 

9 = 

10 = 31 
11 = ANY 

ote ayes AA AMODE for the Main Entry Point 
00 = 24 
10 = 31 
11 = ANY 


Figure 50 (Part 2 of 2). Module Attributes 
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Partitioned Organization Directory Record 


As built by linkage editor ) 


Name of load module (member or clias name) 











Alias indicator and 
miscellaneous info (see below) 


Relative (to beginning of data set)track address of 
module (TTR) 

















12 Byte of binary 


zeros 


Relative (to beginning of data set)track address of first 
text record (TTR) 





Number of entries 
in note list* 






16 Relative (to beginning of data set)track address of note 


list or scatter/translation record (TTR) 











Total contiguous virtual storage required 


Module Attributes 1 (see Figure 50) 
0, 1,2, 3,4, 5,6, 7, 8, 9, 10, 11, 12, 13, 14, 15 


for the module Length (in bytes) of First text record Module's linkage 


editor assigned entry point address Module Attributes 2 AMODE/RMODE information 
(see Figure 50) (see Figure 50) 


Authorization Code Length** Authorization Code** 


20 






24 





28 









32 


For load modules in scatter format add: 












Length of scatter list (in bytes) Length of transla~ 
tion table (in bytes) ESDID (CESD entry number of control ESDID (CESD entry 
section name) for first text record number of control 
Authorization Code Length** Authorization Code** 
aining entry point 


For load modules with alias names add: 






40 











Entry point address of the member name 


Member name 


Authorization Code Length** Authorization Code* * 
For load modules with SSI bytes: 


SSI bytes - Aligned on a halfword boundary at the end of the PDS 
record, 
Authorization Code Length** Authorization Code** 










Legend: 
Alias indicator and miscellaneous information: 
Bit Meaning 
0 0 signifies none 


1] signifies alias 
1,2 number of relative track addresses (TTR) in user data field 
3-7 length of user data field (in halfwords) 


PODS Directory Record size: 


Format Bytes 
Block 36 -- when rounded to a halfword boundary (with alias names, 44 bytes) 
Scatter 44 (with alias names, 54 bytes) 


Note: For SS}, add 4 bytes to sizes given above. 
*This. byte contains a zero if load module is not in overlay. 
**The authorization code fields will appear only once. They are always the last fields of 
the directory record. The size of the directory determines in which of the four locations 


they appear. 


Figure 51. Partitioned Organization Directory Record (CAs Built by Linkage Editor) 
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Relative Relocation Constant Table 


Built by and referred to by Address Assignment Processor 


ae ae a 


Relocation Constant = (linkage editor assigned address)-(previously assigned address) of a 
control section (SD, PC or CM) or a label reference (LR). The 
entries are one for one with CESD, in true or complement form. Com- 
plement form specified by binary ones in the high-order byte (4 bytes) 





Figure 52. Relocation Constant Table (RCT) 








Renumbering Table (RNT) 


Built by ESD Processor 
Referred toby TXT, RLD, END and ESD Processor 





Section Definition (SD) xxxx 0000 Subclassification - 
Label Reference (LR) wou 0011 Delete xxxT xxxx 
Private Code (PC) woe 0100 Replace xxx} xxx 
Common (CM) woo 0101 Chain xT KX 
Pseudo Register (PR) woo 0110 Insert wx} 2000 
Null 0000 O111 Library = Tx xxx 
External Reference xxxx 0010 

Weak External Reference (WX) xxxx 1010 

(1 byte) 


Flag - to indicate that the section definition (SD or PC) to which this entry corresponds is present 
in the CESD (0000 0001), or that other CESD items are dependent on its presence (0000 0010), 
or that a Delink Table entry was created for this symbol (0000 0100) -- 1 byte 


CESD entry number (ID) - points to an entry in the CESD -- 2 bytes 


Figure 53. Renumbering Table (CRNT) 
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RLD Input Control Block* 


Build and referred to by Second Pass RLD Processor 








Address of RLD note list entry 
marking the end of the RLD 
grouping (4 bytes ) 


Address of current RLD note list entry 
being processed (4 bytes ) 


Address of RLD note list entry marking the 
beginning of the RLD grouping (4 bytes) 
Beginning address of RLD input buffer (4 bytes ) 


Lowest RLD address of unprocessed RLDs in current RLD set (3 bytes ) 


Flags (1 byte) 
BitO - 1 Control block in use 


Bit 3 - 0 Control block governs RLD input buffer 1 
1 Control block governs RLD input buffer 2 


* There is a control block for each of two input buffers. 


Figure 54. RLD Input Control Block 
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RLD Output Control Block * 


( Built and referred to by Second Pass RLD Processor 









Address of end of buffer - 4 
(4 bytes ) 


Address of beginning of buffer (4 bytes ) 


First free address in the buffer (4 bytes ) 
Length in bytes of ID-length list (2 bytes ) 


Flags- Byte | BitO- 1 Control block in use 
Bit 1 - 1 Buffer is being written 


Byte 2 Bit 8 - 15 Constant to turn off use bits in 
the text control block 
For: Buffer 1 - X 'DB' 
Buffer 2- X 'ED' 
Buffer 3- X 'Fé' 


* There is a control block for each of three RLD output buffers. 


Figure 55. RLD Output Control Block 
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RLD Note List 


Built and referred to by First Pass RLD Processor F 


a 


Address - displacement in words from beginning of record; TTR if last 
entry of a group (3 bytes) 






Length - number of words of RLD data (2 bytes) 


Lowest Multiplicity - of the control section referred to by the ID field to which the 
RLD information in this record pertains (10 bits) 


Flag - Bit Meani 
60 o= RLDe are not in virtual storage 


1 =RLDs ore in virtual storage 


1 0 = Entry is grouped 
1 = Entry contains a TTR 
2 0 = Not processed 
1 = Processed 
3 0 = RLDs are in Buffer | 
1 = RLDs are in Buffer 2 
4 0= 
1 = Split RLD in set (Second Pass) 
? a 2 
1 = Currently being processed (Second Pass) 


ID - CESD entry for the control section (SD or PC) to 
which this RLD information pertains (2 bytes) 


Figure 56. RLD Note List 
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Second Pass Text Control Block * 


Built and referred to by Second Pass Text Processor 


CCW displacement for text (4 bytes) 
Accumulated length of text (2 bytes) 


Length of current text (2 bytes) 


Address of text 1/O table entry marking end of 
text grouping (4 bytes) 


Address of text |/O table entry marking beginning of text 
grouping (4 bytes) 


Address of current text |/O table entry being processed (4 bytes) 


End address of text in buffer (4 bytes) 


Beginning address of text in buffer (4 bytes) 


Flags (4 bytes) 


Byte | BitO-1 Control block in use 
1-1 Text being written 
2-1 Text being read 
3-1 Text has RLDs 
4-1 Text is first of group. 
5-1 Text is last of group 
6-1 Text is last in segment 
7-1. Text is last in load module 


0-1 XDAP write needed 

] = 1 Dummy write needed 

2-1  RLD output buffer 1 is being used 

3-1  RLD output buffer 2 is being used 

4-1  RLD output buffer 3 is being used 

5-1 RLD output buffer 1 contains [D-length list for 


this text 

6-1  RLD output buffer 2 contains ID-length list for 
this text 

7-1  RLD output buffer 3 contains ID-length list for 
this text 


Byte 3 BitO-1 RLD input buffer 1 contains RLDs for this text 
1-1  RLD input buffer 1 contains processed RLDs for 
this text 
2-1  RLD input buffer 2 contains RLDs for this text 
3-1  RLD input buffer 2 contains processed RLDs for 
this text 
4-1 There is more text to process after current text 


* There are two text control blocks - - one for current text being processed, another 
for next text to be processed or text just processed. 


Figure 57. Second Pass Text Control Block 
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Segment Length Table (SEGLGTH) 
Built and referred to by Address Assignment Processor 


Appearance of table after assignment of control section addresses 


SHUT UT UT I 


Highest ID or ENTAB Entry Count for Segment (2 bytes) 


Flag (1 byte) Bits 0 through 3 not used 
Bit 4 = 0 -- next two bytes contain the highest ID of the segment 


= ] == next two bytes contain the number of ENTAB entries for this segment 


Bits 5,6,7 - The low-order three bits of the previously assigned address of the first contral section of 
this segment 


Cumulative Segment Length - in bytes, of control sections in this segment {including the ENTAB, if present) (3 bytes) 


Appearance of table after segment addresses are determined 
Segment Relocation Constant - for the segment that corresponds to this entry (3 bytes) 


Path Length - in bytes, of this segment, including this segment and its ENTAB (3 bytes) 


Figure 58. Segment Length Table (SEGLGTH) 
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Segment Table (SEGTAB) 


Built by Intermediate Output Processor 













TEST 


indicator 


Last segment Highest segment no. 

number of region | in storage-region | 

Last segment Highest segment no, 

number of region 3 in storage-region 3 
(Not used in the Fixed-Task Supervisor) ‘ 


Previous segment * Status 
Zero indi 
number for segment | indicator 
Previous segment Address of entry table entry (when caller Status 
number for segment 2 chain exists) * indicator 





Address of data control block (DCB) used to load module - 


Address of note list 



















Last segment 
number of region 2 


Highest segment no, 
in storage-region 2 













Last segment 
number- of region 4 











(Not used in the Fixed-Task Supervisor) : 












Previous segment Address of entry table entry (when caller Status 
number for segment N chain exists * indicator 


——— 4 bytes ae ee 


Legend: 
TEST indicator -- specifies that this module is "under test" using TESTRAN. Bit | is initialized by program fetch. 
Highest segment no. in storage -- is initially set to 00 except for region | which is initially set to 01 by linkage editor. 
Status indicator -- indicctes the stotus of this segment with the two last bits of the entry table address field as follows: 


Bits Meaning 

00 segment is in virtual storage as a result of a branch to the segment. 
10 segment is in virtual storage ; no caller chain exists. 

01 segment is not in virtual storage, but isscheduled to be loaded. 

1 segment is not in virtual storage. 


Note: The status indicator for segment 1 is initially set to 10; all the rest are initially set to 11. 


* Set to zero by linkage editor. 


Figure 59. Segment Table (SEGTAB) 
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TABLE 


Referred to by HEWLMBTP j 


Pointer - to beginning of a group of entries in LIST (2 bytes) 







LIST 
Referred to by HEWLMBTP 


» IT Fe 


End of Message Indicator - delimits a group of entries that define 
a message (1 byte - hex FF) 


Pointer - to the first character of a phrase (2 bytes) 


Count-1 - of characters in the phrase (1 byte) 


Figure 60. TABLE and LIST (Referred to by HEWLFBTP) 








TEXT I/O TABLE 


Built and referred to by First Pass Text Processor 


Bi ae 2 


Multiplicity Number of this piece of text (10 bits ) 





Flags 
(6 bits)-- Bit | Meaning 

0 Text is not in virtual storage 
Text is in virtual storage 


_- oO 


Corresponding TXT note list entry is a grouped entry 
Corresponding TXT note list entry contains a TTR 


— 
>) 


Text not out-of-order 
Out-of-order text 


Le] 
=_ © 


Text has not been processed (second pass) 
Text has been processed (second pass) 


WwW 
—_— © 


Corresponding TXT note list entry contains a true length of the text 
Corresponding TXT note list entry contains a full multiplicity length 
which is larger than the actual length of the text 


5 Not used 


ff 
—O 


ID -- CESD entry for this control section (SD or PC) (2 bytes 


Figure 61. Text I/0 Table 
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TEXT NOTE LIST 


Built and referred to by First Pass Text Processor 






Length - number of bytes of text (2 bytes) 


Address - storage address if text is in virtual storage, 
TTR if non-grouped entry or last 
entry in a group (3 bytes) 


Displacement - location of this text relative to the beginning 
of the multiplicity - used only for out-of-order 
text (2 bytes ) 


Figure 62. Text Note List 


XAD2CESD TABLE 
Built and referred to by Cross-Reference Table Routine 





Composite ESD entry number - specifies the CESD entry containing the 
symbol (2 bytes) 


Figure 63. XAD2CESD Table (Built and Referred to by 
Cross-Reference Table Routine) 
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ORDER TABLE 
Built by HEWLFSCN 


‘| | 






CESD Identifier (2 bytes) 


Indicators (1 byte): Bit O - Entry matched in CESD 
Bit 1 - Unused 
Bit 2 - ORDER required 
Bit 3 - PAGE alignment required 


Bits 4-7 - Unused 


Figure 64. ORDER Table (Built by HEWLFSCN) 
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DIAGNOSTIC AIDS 


C 


This section contains information that may be useful in 
diagnosing difficulties with the linkage editor program. 
Included are: register contents at major entry points 

(Figure 65), charts describing buffer (see Figure 66 on page 
187) and table allocation (Figure 67 on page 188), and an error 
message—module cross-reference table (Figure 68 on page 189). 


Module 
Entry Point 


HEWLCIDR 


HEWLFADA 


HEWLFBTP 


Pointer to parameter list 

Address of all-purpose table 
Address of save area 

Return address 

Entry point address 

Address of all-purpose table | 
Return address 


Entry point address 


Address of all-purpose table 
Save are address 


Return address 


HEWLFENS 
HEWLFENT 


Figure 65 (Part 1 of 5). General Register Contents at Major Entry Points 


Address of all-purpose table 


Save area address 


1 
2 
13 
14 
15 
2 
2 
14 
15 
HEWLFEND 2 Address of all-purpose table 
4 Length of any no-length control section 
5 ID of the assembled address of the module entry point 
13 Address of save area 
14 Return address 
15 Entry point address 
2 
13 
14 





Return address 
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Module 
Entry Point 


HEWLFESD 


Address of all-purpose table 


Byte count of ESD information 


ID of first ESD item to be processed 


Address of first ESD item to be processed 
Save area address 

Return address 

Entry point address 


Address of all purpose table 


Pointer to parameter list 





HEWLFFNL 
HEWLFIDR 


—- > 
Ny = wa SF Ww OO YI fF A 


Address of all-purpose table 


- 
wl 


Address of save area 


-_ 
Ps) 


Return address 


- 
Wl 


Entry address 





HEWLFINC 2 Address of all-purpose table 





12 Return address 
15 Entry point address 
HEWLFINP 2 Address of all-purpose table 
Entry point address 
HEWLFINT 1 Address of parameter list 
13 Save area address 
14 Return address 
15 Entry point address 
HEWL FMAP 2 Address of all-purpose table 


14 Return address 


-— 
a 


15 Address of entry point 
HEWL FOPT 1 Address of parameter list 
2 Address of all-purpose table 


14 Return address 


Entry point address 
Address of all-purpose table 


Figure 65 (Part 2 of 5). General Register Contents at Major Entry Points 


HEWLFOUT 


- 
Vi 
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Module 
Entry Point 


HEWLFRAT 


Address of all-purpose table 


C 


Byte count of RLD input 


2 
G 
6 


Storage address of RLD input 






—_ 
ys 


Return address 
HEWLFRCG Address of all-purpose table 

Address of ESD item being processed 

Address of beginning of replace/change chain 
Entry point address 


HESD address of either first ENTAB entry Cif overlay) or 
last HESD entry + 8 


HEWLFREL 


Address of all-purpose table 
Return address 


Entry point address 


HEWLFROU Address of parameter list 
Address of save area 


Return address 


Entry point address 
HEWLEPNT 2 Address of all-purpose table 


c 


14 Return address 
15 Entry point address 
HEWLFLOG 0 Error Code 
1 Address of first symbol Coptional) 
2 Address of all-purpose table 
13 Address of second symbol Coptional) 
14 Return address 
15 Entry point address 
HEWLFALK 2 Address of all-purpose table 
14 Return address 
15 Entry point address 


Address of first ENTAB entry in HESD, if overlay; 
otherwise, address of last HESD entry + 8 


HEWLFSCD 


13 
14 
15 





Address of all-purpose table 


Figure 65 (Part 3 of 5). General Register Contents at Major Entry Points 
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Ed 
Entry Point | Reg 
GETIDMUL 0 Indicator: 0 - prime read; = lookahead wd 
1 Text control block address | 
14 Return address 
HEWLFSCN 1 Address of column 1 of input record 
2 Address of all-purpose table 
15 Entry point address 


HEWLFSIO ) 2 | Address of all-purpose table | 


CHECKRD 10 Base register of HEWLFSIO 
12 Address of HEWLFSCD 





14 Return address 


Address of HEWLFRLD 
HEWLFSYM A 


CHECKWRT 


Base register of HEWLFSIO 
Address of HEWLFSCD 


Return address 


Address of HEWLFRLD 





WRTCRRLD Address of control block for buffer to be written 

Base register of HEWLFSIO 

Address of HEWLFSCD es 
Return address 

Address of HEWLFRLD 

Address of all-purpose table 


Save area address 


Return address 


Entry point address 


15 

10 

12 

14 

15 

1 

10 

12 
14 
15 

2 

13 

14 
15 

HEWLFTXT 2 Address of all-purpose table 

3 | Assembled address of first byte of text 
4 Byte count of TXT input 

5 ID of current text record 
7 Base register of HEWLFTXT 
12 Base register of HEWLFRAT 
14 


Return address 





Figure 65 (Part ¢ of 5). General Register Contents at Major Entry Points 
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Module 
Entry Point Contents 


HEWLCAUT Address of all-purpose table 
Return address 


Entry point address 


RELOCATE Address of all-purpose table 


Address of text control block for current text 
Return address 


Address of HEWLFREL 





Figure 65 (Part 5 of 5). General Register Contents at Major Entry Points 


BUFFER ALLOCATION - ( LINKAGE EDITOR) 


Initial and Input Processing Intermediate Processing Second Pass Processing 


Object Module Buffer 1 
3200 bytes (max.) or 800 bytes or 400 bytes (min.) 


Object Madule Buffer 2 
3200 bytes (max.) or 800 bytes o 400 bytes (min.) 
SYSLIN Buffer | 
3200 bytes (max.) or 800 bytes or 400 bytes (min.) 
SYSLIN Buffer 2 
3200 bytes (max.) or 800 bytes or 400 bytes (min.) 


Print Buffer 1 

4840 bytes (max.) or 1216 bytes or 608 bytes (min.) 
Print Buffer 2 

4840 bytes (max.) or 1216 bytes or 608 bytes (min.) 


RLD Buffer Area 
1024 bytes 


Text Buffer Area 
102400 bytes (max.) or 6144 bytes (min. 


Initial and Input Intermediate Second Pass 
Processing Tables Processing Tables Processing Tables 





Figure 66. Buffer Allocation 
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Allocated 


—_ a 


for Overlay 
Link-Edit Orderof Bytes/ Inp. Int. 2nd 
Table Name Only Allocation Entry Weight | Proc. Proc. Pass | Prefix Align. 







Alias Table No 2 1 0 No Yes Yes No Dblwd 160 160 
Calls List Yes 17 1 96 Yes Yes No No — Dblwd 1536 : 
Composite ESD No 3 16 288 Yes No No Yes  Dblwd 4608 : 























Delink Table Yes Dblwd 
Entry List Yes 18 6 96 No No Yes No Dblwd 1536 ? 
Half ESD No  Dblwd 












Half ESD 





No Dblwd 


Prefix 

HIERARCHY! No 15 1 18 Yes Yes No Yes ODblwd 288 : 
IDRTRTAB2 No 18, 20 1 12,45 Yes Yes No No ODblwd 192, 208 *° 
IDRUDTAB No 22 1 88 Yes Yes No No _ Dbiwd 960 ? 
IDRZPTAB No 23 1 44 Yes Yes No No _ Dblwd 455 > 
Order No 14 1 28 Yes Yes No No _ Dblwd 456 5 
First Pass No 1 1 O Yes No No No Dblwd 256 256 


RLD Buffer 


Second Pass No 11 1 0 No No Yes No Dblwd 768 768 
RLD Buffer 


Relocation 
Constant Table/ 

Renumbering 
Table 


RLD Note 232 
List | 
RLD Note 928 
List II 
SEGTAT 256 256 


Text I/O 
Table 

Text Note 
List | 

Text Note 
List Il 


1Not used in virtual systems 
2 Table allocated in two parts. 
3 Maximum is determined by storage availability. 


Figure 67. Table Allocation 
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Figure 68 contains a list of error messages and the routines and 
CSECTs in which they originate. Each message contains a 
severity code in the final position of the message code. These 
( severity codes are defined as follows: 


0 Indicates a condition that will not cause an error during 
execution of the link-edited program. 


1 Indicates a condition that may cause an error during 
execution of the link-edited program. 


e Indicates an error that can make execution of the 
link-edited program impossible. 


3 Indicates an error that will make execution of the 
link-edited program impossible. 


§ Indicates an unrecoverable error. Such an error causes 
termination of linkage editor processing. 


Error Issuer 
Message ; 
Number Error Message Text Routine CSECT 


TEWO000 Control statement HEWLFSCN HEWLFSCN 


ERROR—Input contains invalid 2-byte relocatable HEWLFREL HEWLFREL 
address constant; constant has not been 
relocated. 


ERROR~——Input contains invalid V-type address HEWLFREL HEWLFREL 
constant; constant has not been relocated. 


ERROR—Invalid entry point from END card; no HEWLFENT HEWLFENT 
entry point assigned. 

ee ERROR—“Input: contains invalid external symbol HEWLFENT HEWLFENT 
ID. 
ERROR—Entry statement symbol printed is invalid HEWLFENT HEWLFENT 
Cnot an external name); no entry point assigned. 


ERROR—END card symbol printed is invalid (not HEWLFENT HEWLFENT 
| an external name); no entry point assigned. 


IEWO073 ERROR—Entry statement symbol printed is not in HEWLFENT HEWLFENT 
root segment of overlay structure; no entry 
point assigned. 


IEWO083 ERROR-—END card symbol printed is not in root HEWLFENT HEWLFENT 
segment of overlay structure; no entry point 
assigned. 


ERROR—END card entry point address printed is HEWLFENT HEWLFENT 
not in root segment of overlay structure; no 
| entry point assigned. 


ERROR—Invalid entry point on END card; entry HEWLFEND HEWLFEND 
point ignored. 


ERROR——Output module contains no control HEWLFENT HEWLFENT 
sections in root segment of overlay structure; 
no entry point assigned. 


IEWO123 ERROR—No ESD entries; execution impossible. HEWLFINP HEWLFINP 
HEWLFADA HEWLFADA 


; Figure 68 (Part 1 of 5). Error Message/Issuer Cross-Reference Table 
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Error 


Issuer 
Message 
Number 





Error Message Text Routine CSECT ) 


IEWO132 ERROR—Symbol printed is an unresolved external HEWLFADA HEWLFADA 
reference. 
IEWO143 ERROR—No text. HEWLFOUT HEWLFOUT 
HEWLFINP HEWLFINP 
IEWO152 ERROR——Invalid overlay structure; no calls or HEWLFENS HEWLFENS 
branches made from root segment. 


TEWO161 


Warning—Exclusive call from segment number HEWLFENS HEWLFENS 


printed to symbol printed - XCAL was specified. 


IEWO172 ERROR—Exclusive call from segment number HEWLFENS HEWLFENS 
printed to symbol printed. 
ERROR—Invalid exclusive call from segment HEWLFENS HEWLFENS 
number printed to symbol printed. 
Warning—Main storage requirements for output ' | HEWLFADA HEWLFADA 
load module have exceeded 512K bytes. 
IEWO201 Warning—Overlay structure contains only one HEWLFADA HEWLFADA 
segment - overlay option cancelled. 


IEWO212 ERROR—Expected continuation card not found. HEWLFINP HEWLFINP 





ERROR——Card printed contains invalid input from HEWLFESD HEWLFESD 
object module. HEWIFINP HEWLFINP 
HEWLFRAT HEWLFRAT 


ERROR—Input from load module is invalid. HENLFRAT HEWLFRAT 
HEWLFINP HEWLFINP 
HEWLFESD HEWLFESD 


IEWO241 Warning——External symbol printed is doubly HEWLFESD HEWLFESD 
defined - ESD type definitions conflict. 
ERROR~—Table overflow ~ too many external HEWLFESD HEWLFESD 


symbols in ESD. HEWLFADA HEWLFADA 
HEWLFSCN HEWLFSCN 


ERROR—Table overflow - input load module HEWLFESD HEWLFESD 
contains too many external symbols in ESD. 


IEWO272 ERROR—Load module from library specified HEWLFINC HEWLFINC 
unacceptable to level F. 


ERROR-~—-DDname printed cannot be opened. HEWLFINT HEWLFINT 
HEWLFRAT HEWLFRAT 
ERROR——DDname printed had synchronous error. HEWLFROU HEWLFROU 
HEWLFFNL HEWLFFNL 


ERROR—Invalid statement - scan terminated. HEWLFSCN HEWLFSCN 
ERROR——Maximum number of regions (4%) exceeded. HEWLFSCN HEWLFSCN 
ERROR——Maximum number of segments exceeded. HEWLFSCN HEWLFSCN 


ERROR—Maximum number of aliases (16) exceeded, HEWLFSCN HEWLFSCN 
excess ignored. 


Figure 68 (Part 2 of 5). Error Message/Issuer Cross-Reference Table 








2 
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Error Issuer 
Message 





Number Error Message Text | Routine CSECT 


ERROR—Library specified does not contain HEWLFINC HEWLFINC 
module. 





ERROR—Table overflow - too many calls between HEWLFRAT HEWLFRAT 
control sections. 

IEW0364 ERROR—Table overflow - input text exceeded | HEWLFRAT HEWLFTXT 
maximum or too many changes of origin in input. HEWLFOUT HEWLFOUT 


IEWO374 ERROR—Table overflow - input contains too many HEWLFRAT HEWLFRAT 
relocatable address constants or too many 





control sections containing such constants. 


ERROR—Text record ID is invalid; card ignored. HEWLFRAT HEWLFTXT 
HEWLFADA HEWLFADA 

ERROR—Member not stored in library - permanent HEWLFFNL HEWLFFENL 

device error. 

ERROR—Member not stored in library - no space HEWLFFNL HEWLFFNL 

left in directory. 

ERROR—Alias not stored in library - no space HEWLFFNL HEWLFFNL 

left in directory. 


IEWO421 Warning—Member not stored in library - HEWLFFNL HEWLFFNL 
identical name in directory; will try to store 
under '"TEMPNAME. ! 


ERROR—Library name printed cannot be opened; DD HEWLFINC HEWLFINC 
card may be missing. 


| TEWOG44 ERROR—Table overflow - too many downward calis. | HEWLFREL HEWLFREL 
ERROR——Table overflow - segment contains too HEWLFADA HEWLFADA 
many downward calls. 


IEWO461 Warning——Symbol printed is an unresolved HEWLFADA HEWLFADA 
external reference; NCAL was specified, or the 
reference was marked for restricted no-call or 
never-call 


IEWO472 ERROR—Invalid alias entry point in overlay HEWLFENT HEWLFENT 
structure. 
ERROR—Table overflow - too many external HEWLFINP HEWLFINP 

| symbols affected by relocation. 

ERROR—Invalid name card found in library; card HEWLFSCN HEWLFSCN 
ignored. 
ERROR—Alias not stored in library - permanent HEWLFFNL HEWLFFNL 
device error. 








ERROR—-INCLUDE statement syntax conflicts with HEWLFINC HEWLFINC 


record format of specified data set - DDname 
printed. 


ERROR—Specified data set has unacceptable HEWLFINC HEWLFINC 
record format - DDname printed. 

ERROR—-Blocksize of library data set exceeded HEWLFINC HEWLFINC 
maximum - DDname printed. 


Figure 68 (Part 3 of 5). Error Message/Issuer Cross-Reference Table 
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Error Issuer 
Message 
Number Error Message Text Routine CSECT ; 


IEW0543 ERROR~—-Identical name in directory. HEWLFFNL HEWLFFNL 
ERROR—Common printed exceeded size of control HEWLFESD HEWLFESD 
section with identical name. 

IEWO564 ERROR—Invalid text origin, linkage editor HEWLFSCD HEWLFSCD 
processing terminated. 

| IEWO572 ERROR—Common printed and subroutine have HEWLFESD HEWLFESD 

identical name. 


Warning—Invalid member name; will try to store HEWLFFNL HEWLFFNL 
under "TEMPNAME. * 


IEWO0594 ERROR——Input data set blocksize is invalid. HEWLFINP HEWLFINP 
HEWLFINT HEWLFINT 
ERROR—Input from object module is invalid - END HEWLFINP HEWLFINP 
card missing. 
ERROR—Length not specified for external symbol HEWLFRAT HEWLFTXT 
printed. 
ERROR—Address constant references null unnamed HEWLFRAT HEWLFRAT 
control section. . 
ERROR—DDname printed had synchronous error -— HEWLFROU HEWLFROU 
XREF aborted. 
IEW0642 ERROR——Symbol printed appeared on control HEWLFADA HEWLFADA 
statement but was not matched. 
ERROR—Conflict in order specified for symbol HEWLFSCN HEWLFSCN ’ 
printed. = 
IEWO670 The specified identify data has been added to HEWLFIDR HEWLFIDR 
the IDR for the control section name printed. 


TEW0682 


ERROR—Control section name on an IDENTIFY HEWLFIDR HEWLFIDR 
control statement is incorrect or the statement 
is misplaced ~- IDENTIFY data ignored. 


IEWO06 94 ERROR—Table overflow - SIZE value specified not HEWLFIDR HEWLFIDR 


large enough for CSECT IDR input ~- Linkage 
Editor processing terminated. 


IEWO704 Unrecoverable error detected in CSECT IDR input HEWLFIDR HEWLFIDR 
~ linkage editor processing terminated. 


IEWO714 ERROR—Member not stored in library - STOW HEWLFFNL HEWLFFNL 
workspace unavailable. 
IEWO722 ERROR—Invalid alias name. HEWLFSCN HEWLFSCN 


IEWO731 Warning—Alias matches member name - alias HEWLFFNL HEWLFFNL 
ignored. 

IEWO740 The indicated action was taken for an EXPAND HEWLFSCN HEWLFSCN 
request. 

IEWO751 Warning—Invalid AMODE/RMODE combination found HEWLFFNL HEWLFEFNL 
in MODE control statement - ignored. | 


Figure 68 (Part 4 of 5). Error Message/Issuer Cross-Reference Table } 
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Error Issuer 
Message 


Number Error Message Text Routine CSECT 


IEWO761 Warning——Invalid AMODE/RMODE combination found HEWLFFNL HEWLFFNL 
in PARM field - ignored. 


IEWO771 Warning-—AMODE/RMODE data in MODE control HEWLFFNL HEWLFFNL 
statement incompatible with OVLY option - 


ignored. 


incompatible with OVLY option ~- ignored. 
IEWO791 Warning—Invalid AMODE/RMODE combination in ESD HEWLFESD HEWLFESD 
data for the named CSECT - ignored. 


IEWO 984 ERROR—SYSPRINT blocksize exceeds maximum - HEWLFINT HEWLFINT 
linkage edit processing terminated. 


TEWO781 Warning—AMODE/RMODE data in PARM field HEWLFFNL HEWLFFNL 





ERROR—-SYSPRINT DD card missing - linkage editor HEWLFINT HEWLFINT 
processing terminated. 


Figure 68 (Part 5 of 5). Error Message/Issuer Cross-Reference Table 
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PPENDIX. INPUT CONVENTIONS AND RECORD FORMATS 


This section contains linkage editor input conventions and 


record formats (see Figure 69 on page 195 through Figure 82 on 
page 204). 


INPUT CONVENTIONS 


Input modules Cobject or load) to be processed ina single 
execution of the linkage editor must conform with a number of 
input conventions. Violations of the following are treated as 
errors by the linkage editor: 


e All text records of a control section must follow the ESD 
record containing the SD or PC entry that describes the 
control section. 


° The end of every input module must be marked by an end 
indication CEND record in an object module; EOM flag in a 
load medule). 


e Each input module may contain only one no-length control 
section (a control section whose length field in its SD or 
PD entry in the ESD contains zeros). The length must be 
specified on the END record of any module that contains a 
no-~length control section. 


° After processing the first text record of a no-length 
control section, the linkage editor will not accept a text 
record of a different control section within the same input 


module. 

® Any RLD item must be read after the ESD items to which it 
refers; if it refers to a label within a different control 
section, it must be read after the ESD item for that control 
section. 

° The language translators must gather RLD items in groups of 


identical position pointers. No two RLD items having the 
same P pointer can be separated by an RLD item having a 
different P pointer. 


° Each record of text!* and each LD or LR entry in the ESD 
record must refer to an SD or PC entry in the ESD. 


° The position pointer of every RLD item must point to an SD 
or PC entry in the ESD. 


e No LD or LR may have the same name as an SD or CM. 


e All SYM records must be placed at the beginning of an input 
module. The ESD for an input module containing test 
translator statements must follow the SYM records and 
precede TXT records. 


e The linkage editor accepts TXT records that are out of order 
within a control section, even though linkage editor 
processing may be affected. TXT records are accepted even 
though they may overwrite previous text in the same control 
section. The linkage editor does not eliminate any RLD 
items that correspond to overwritten text. 


e During a single execution of the linkage editor, if two or 
more control sections having the same name are read in», only 


14 A common (CM) control section cannot contain text or Jo 
external references. 
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the first control section is accepted; the subsequent 
control sections are deleted. 


e The linkage editor interprets common (CM) entries in the ESD 
(blank or with the same name) as references to a single 
control section whose length is the maximum length specified 
in the CM items of that name Cor blank). No text may be 
contained in a common control section. 


e Within an input module, the linkage editor does not accept 
an SD or PC entry after the first RLD item is read. 


To avoid unnecessary scanning and input/output operations, input 
modules should conform with the following conventions. Although 
violations of these rules are not treated as errors, avoiding 
them will improve the efficiency of linkage editor processing. 


° Within an input module, no LD or SD may have the same name 
as an ER. 


e Within an input module, no two ERs may have the same name. 

e Within an input module, TXT records may be in the order of 
the addresses assigned by the language translator. CIf TXT 
records are not in address sequence, each reorigin operation 
may require additional linkage editor processing time. ) 


e SYSUT1 record size should be at least as large as SYSLMOD. 


Figure 69 through Figure 82 on page 204 are the card image and 
load module record formats for the Linkage Editor. 


SYM Input Record (Card Image) 






TESTRAN data 


Number of bytes of TESTRAN data 


SYM 


12-9-2 (0000 0010) 






Figure 69. SYM Input Record (Card Image) 
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ESD Input Record (Card Image) 


Not used 












ESD Data - see below (up to 3 data items per record) 
Blank if all ESD items are LD 


ESD IDENTIFIE!Rof first ESD item (other than LD) 
Blank 












Number of bytes of ESD data 
ESD 


12-9-2 (0000 0010) 
ESD Data Item 


Zero - if length is on END record. 
Length of control section (if type is: SD, PC, CM) 


Identifier of SD entry containing name 
Blank if type is ER, WX 
Length of pseudo register (PR) 











-— Alignment factor (PR) 
07 — doubleword alignment 
03 — word alignment 
01 — halfword alignment 
00 — byte alignment 
AMODE/RMODE/RSECT data (SD,-PC) 
XXMM LL. not used 
Pa a cone RSECT information 
0 = not read-only 
1 = read-only 
ee 5 oe RMODE data 
0 = 24 
1=ANY 
sae aie ane AA AMODE data 
00, 01 = 24 
00 = 31 
11=ANY 
Blank (LD, ER, CM, Null, WX) 


24 bit address (SD, PC, LD) 
Type - Hex (00=SD, 01=LD, 02=ER, 04=PC, 05=CM, O6=PR, OA=WxX) 


Name - when type is: SD, LD, ER, CM, PR, WX 
Blank - when type is: PC or blank CM 








Figure 70. ESD Input Record (Card Image) 
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Text Input Record (Card Image) 


[aba ppagad om SC~—~—CSSSS Cw 


Text data (machine language code) Niet used 
ESD Identifier of SD for control section of this text 
Blank 
Number of. bytes of text date 
Blank 
24 bit address of first byte of text data 
Blonk 
TXT 
12-9-2 (0000 0010) 
Figure 71. Text Input Record (Card Image) 








RLD Input Record (Card Image) 









RLD data - see below 







Blank 


Number of bytes of RLD data 


RLD 


12=-9-2 (0000 0010) 
RLD data item 


12 |.a 6.708 


Assigned address of address constant 









Flag field -- (TTTTLLSTn) 


=f S=Direction of relocation 
0000=nonbronch O=positive (+) 
0001 =btanch l=negative (-) 


001 1=pseudo register cumulative length Tn=type of next RLD item 
LL=length of address constant O=next RD item has a different R or P 
oT=2 Stel pointer; they are present in the next Item 
10=3 bytes l=next RLD item has the same R and P point- 
11=4 bytes ers, hence they are omitted 

Position pointer (P) - ESDID of SD for control section thot contains the address constant 


Relocation pointer (R) - ESDID of CESD entry for the symbol being referred to (zero (00) if type=PR cumulative length) 


Figure 72. RLD Input Record (Card Image) 
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END Input Record - Type | (Card Image) ~ 
fae [s] ee | ore sel are ee | eo 


See Below 
Control section length for control section whose length was not specified 
ssa in SD ESD item. Byte 29 is binary zero if length is present. 
ESDID of SD item for this control section that contains the entry point address specified in columns 6-8. 
Blank 
24 bit address of entry point (optional) 
Blank 


END 


12-9-2 (0000 0010) 


Figure 73. END Input Record—tType 1 (Card Image) 








END Input Record - Type 2 (Card Image) 





See Below 
Control section length for control section whose length was not specified 
in SD ESD item 
Blank 
Symbolic entry point name (optional) 
Blank 
END 


12-9=2 (0000 0010) 


Figure 74. END Input Record——Type 2 (Card Image) 
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When present, same format as 
columns 34-52, but data applies 
to a processor which produced 
the source code for the processor 
described in columns 34-52 
(PL/S compiler) 


Day of year (ate of compilation or assembly) 
Last two digits or year (date of compilation or assembly) 


Modification level of processor (01 to 99) 
Version level of processor (01 to 99) 


Translator identification ~ PID order number or equivalent, 
left. justified and padded to the right with blanks. 
Flag field: 
Blank = no IDR information in this record (provides 
compatibility with existing format) 
EBCDIC 1 = one IDR item follows 
EBCDIC 2 = two IDR items follow 


Figure 75. IDR Data in an Object Module End Record 








SYM Record - (Load Module) 


ce ae a | re 


SYM data and ESD data (ESD type SD, CM, and PC items) - (maximum of 240 bytes) 







Count - in bytes, of SYM and ESD data (2 bytes) 


Subtype - specifies information for TESTRAN ~ (1 byte) 

1000 0000 - this SYM record contains ESD items (SD, PC or CM) from 
a load module that was not "under test". The TEST attribute 
was not specified when it was link edited. 

0000 0000 - this SYM record is not the above type. 





® Identification - specifies this is a SYM record ~- 0100 0000 (1 byte) 


Figure 76. SYM Record (Load Module) 
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CESD Record - (Load Module) 


|e or] o2e 







ESD data - see below 
Count - in bytes, of ESD data (2 bytes) 
ESDID of first ESD item (2 bytes) 


Spare - binary zeros (2 bytes) 


Flag (1 byte) 
Oxxx xxxx — byte 12 of CESD data items contains segment numbers 
1xxx xxxx — byte 12 of CESD data items contains AMODE/RMODE/RSECT data 


Identification -- 0010 0000 (1 byte) 


CESD Data (Load Module) 


Lee ee 


IDAlength - length (3 bytes), when type is: SD, PC, CM, or PR 


ID (2 bytes), when type is LR 


up to 240 bytes of ESD data 


zero (3 bytes), when type is WX, Null or ER (Hex '06' indicates never call) 


Zero (ER, WX, Null) 


If flag byte (byte 1) indicates CESD data items contain segment numbers, segment number (SD, PC, CM, LR) 


If flag byte (byte 1) indicates CESD data items contain AMODE/RMODE/RSECT data — 


XMKM Lo. not used 
.. RR...  RSECT information 
O = not read-only 
= read-only 
eee ee RMODE data 
0=24 
1=ANY 
Se oue lok AA AMODE data 
00, 01 = 24 
10= 31 
11 = ANY 
(SD, PC) 


Alignment factor (PR) 
07 = doubleword 
03 = fullword 
01 = halfword 
00 = byte 


Address - linkage editor assigned address of this symbol. Zero when type is ER, WX or Null (3 bytes). 


Type - Section Definition (SD) xxxx 0000 | Subclassification 

~ Label Reference (LR) wou 0011 elete 200 T EX 
Private Code (PC) xxxx 0100 } Replace xx T 2008 
Common (CM) xxxx 0101 | Insert 20 1x 2000 
Pseudo Register (PR) xxx 0110 | Chain x 1x 29008 
Null 0000 0111 | Map Thee. 0x00 
External Reference (ER) xoxx 0010 
Weak External Reference (WX) xxxx 1010 
(1 byte) 


Private Code marked delete 
(ENTAB and SEGTAB control sections) xxx! x100 


Symbol - The eight-character external name (zero when type is Null) 


Figure 77. CESD Record (Load Module) 
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‘Scatter/Translation Record 


lo] | 2-3 | 4-1023 Up to and including 1020 bytes 


= 







Data - may contain translation table or scatter table; or both, if both will fit in 1020 bytes. 
Count - in bytes, of data field (2 bytes) 
Zero - binary zeros (1 byte) 


Identification - identifies this as a scatter/translation record - 0001 0000 (1 byte) 


Translation Table 


BEE Sens 





Padding—if necessary, to force fullword boundary alignment 
of scatter table (2 bytes) 
Translation Table Entry - pointer to the scatter table entry that contains 
the address of the control section containing 
this CESD entry. Number of translation table 
entries = number of CESD entries +1 =n. 
Pointer will be zero if its corresponding CESD 
entry is not SD, PC, CM, or LR. (2 bytes) 





Zero - binary zeros (2 bytes) 


Scatter Table 


( psa Table Entry (4 bytes) 


gettin, 


bh ti Th 


Assigned Address - of a control section (SD, PC, or CM) (3 bytes) 






Flags (1 byte) 
XXMK 2. X, not used 
.R... RSECT information 
O = not read-only 
= read-only 

igen SAG RMODE data 
0=24 
1= ANY 


Doge Hacer H Hierarchy (OS/MVT) 
O = processor storage 
1 = 2361 storage 
Zero - binary zeros (4 bytes) 


Translation Table and Scatter Table 


Scatter Table Entry 
Binary Zeros (4 bytes) 







Translation data (2 bytes) Padding - if necessary to align scatter table to a fullword boundary (2 bytes) 
Binary Zero (2 bytes) 


Figure 78. Scatter/Translation Record 
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Control Record - (Load Module ; 
ot-2|3]as/67] eis 16-255 Record Length 20 to 256 bytes for level F 


Control Data -- see below 








Channel Command Word (CCW) - that could be used to read the text record that follows. The data address field 


contains the linkage editor-assigned address of the first byte of text in the text record that follows. 
The count field contains the length of the succeeding text record. (8 bytes) 


Count - binary zeros (2 bytes) 


Coynt - in bytes, of the control data (CESD 1D, length of control section) following the CCW field (2 bytes) 


Count (1 byte) - of RLD and/or CTL/RLD records following next text record 
Spare - binary zeros (2 bytes) 


Identification (1 byte) - specifies that this is: 
@ acontrol record - 0000 0001 


@ the control record that precedes the last text record of this overlay segment - 0000 0101 (EOS) 


@ the control record that precedes the last text record of the module - 0000 1101 (EOM) 


Control Data 
J 
CyteLIcytl Cyl 
Length of text record and/or length of control section - specifies the 


length of the control section (in bytes) to which the text in the 
following record belongs, or the number of bytes of a control 
section contained in the following text record (2 bytes) 


CESD entry number - specifies the composite external symbol dictionary entry that 


contains the control section name of the control section of which this text is a part (2 bytes) 






Figure 79. Control Record (Load Module) 
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Relocation Dictionary Record - (Load Module) 


loft.2|a|as|e7] a5 16-255 Record length can be between 24 and 256 





RLD dota -- see below 
Spore - binary zeros (8 bytes) 
Count - in bytes, of the relocation dictionary information following the spare 8-byte field (2 bytes) 
Count - binary zeros (2 bytes) 
Count (1 byte) - of RLD and/or CTL/RLD records following next text record 


Spore - binary zeros (3 bytes) 


identification (1 byte) - specifies that this is: 
e arelocation dictionary record - 0000 0010 
@ the last record of the segment - 0000 0110 
e the last record of the module - 0000 1110 









Address - linkage editor assigned address of 
the address constant (3 bytes) 

Flag - (1 byte) When byte format is xxxxLLST, 

specifies miscellaneous information as follows: 

xxxx specifies the type of this RLD item (address constant). 

0000 -- nonbranch-type in assembler language, DC A (name) 

0001 -- branchtype in assembler language, DC V (nome) 

0010 -- pseudo register displacement value 

0011 -- pseudo register cumulative displacement value 

1000 and 1001 -- this address constant is not to be relocated because it refers to an unresolved symbol 

LL specifies the length of the address constant. 

01 -- two byte 

10 -- three byte 

11 == four byte 

S specifies the direction of relocation. 

0 -- positive 

| -- negative 

T specifies the type of the next RLD item. 

0 -- the following RLD item has a different relocation and/or position pointer 

1 -- the following RLD item has the same relocation and 

position pointers as this and therefore is omitted 
Position pointer (P) - contains the entry number of the CESD entry (or translation table entry) 
that indicates which contro! section holds the address consrant (2 bytes) 


Relocation pointer (R) - contains the entry number of the CESD entry (or translation table entry) that indicates which symbol value 
is to be used in the computation of the address constant's value (2 bytes) 


Figure 80. Relocation Dictionary Record (Load Module) 
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Control and Relocation Dictionary Record - (Load Module) 


Ce a ee ee 


Sree record (2 byte) 
CESD entry number (2 bytes) 
Address 
Flog 
Address (3 bytes) 
Flog (1 byte) 
Position pointer (2 bytes) 
Relocation pointer (2 bytes) 
Channel Command Word (8 bytes) 
Count, in bytes, of RLD information (2 bytes) 
Count, in bytes, of control information following the last RLD address field. 


The control information contains the ID and length of control sections in the 
following text record. (2 bytes) 


Spore (3 bytes) 


Identification (1 byte) - specifies that this record is: 
@ a contro! and RLD record - 0000 0011- (it is followed by a text record) 
@ a control and RLD record that is followed by the last text record of a segment - 0000 0111 (EOS) 
@ acontrol and RLD record that is followed by the last text record of a module - 0000 1111 (EOM) 


Notes: For detailed descriptions of the data fields see Relocation Dictionary Record and Control Record. 
The record length varies from 20 to 256 bytes. 


Figure 81. Control and Relocation Dictionary Record (Load Module) 








CSECT Identification Record 


record length 7 to 256 bytes 


IDR data - see below 









Sub-Type Indicator - specified type of IDR data 

contained on this record (bits 1-3 reserved) 

---- 0001 data supplied by HMASPZAP 

---- 0010 Linkage Editor data 

---- 0100 Translator-supplied data 

---- 1000 User (System)-supplied data (from IDENTIFY function) 
]--- ---- Indicates the last IDR of this load module 


Byte Count - of IDR data in this record, 
including this field (value range 6 to 255), 


Identification - indicates that this ts: 
1000 0000 - a CSECT Identification record, 


Figure 82 (Part 1 of 3). Record Format of Load Module IDRs 
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HMASPZAP Data 


{| 


Up to 18 repetitions of bytes 1 through 13 









Data specified during HMASPZAP processing * 


Data of HMASPZAP processing (packed decimal) YYDDD 


ESDID of CSECT processed by HMASPZAP 


Flags and count 
Bit O - reserved 
Bit 1 - chain bit - a 1 indicates that the next record is 
also available for HMASP ZAP data. 
Bits 2~7~ number of HMASPZAP entries used on this record 
(value range 0 to 19) 


*May be a PTF number or up eight bytes of variable user 
data specified on an HMASPZAP IDRDATA control 
statement. 


Linkage Editor Data 


Date of last linkage editor processing 
of this module (packed decimal) YYDDD 








Version and Modification level of the linkage editor 
that produced this module (packed decimal) VVMM 


Program Name of the linkage editor that produced this module 


Figure 82 (Part 2 of 3). Record Format of Load Module IDRs 
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Translator Data ) 
jor] vorable 
Translator description (see below) 
. ES 


DID (s) of CSECT (s) whose object code was produced by the translator 
described in this data item. This field is repeated as many times as 
necessary with the high order bit of the last ESDID ir the list set to 1. 





Translator Description (This portion is an optional extension for PLAS) 


When present, same as bytes 1-15, but data 
applies to a translator whose output is source 
code (a PL/S compiler) 











Date of compilation/assembly (packed decimal) YYDDD 
Version and Modification level of translator (packed decimal) VWMM 


Program name of translator, left justified and padded to the right with blanks 


| 
Indicator 2? 


0000 0000 - only one translator was described on object END card for these CSECTs 
0000 0001 - two translators were described on object END card (that is, PLAS. Compiler 
and Assembler) and are included here. 


User Data (Linkage Editor IDENTIFY Function) 


From 1 to 40 bytes of variable user (or system) supplied 
data as specified on the Linkage Editor IDENTIFY, control 
statement. Assumed to be printable EBCDIC characters. 










Count - number of characters in the user data field 


Date on which this data was supplied to the module via the linkage 
editor IDENTIFY control statement. 


ESDID of the CSECT to which the user data applies. 


Figure 82 (Part 3 of 3). Record Format of Load Module IDRs 
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A-type address constant 
delinking of 
relocation of 61 
RLD processing for 45 
absolute relocation 18 
See also absolute relocation factor, 
relocation 
examples 63 
in entry processing 56 
absolute relocation factor 62 
See also absolute relocation 
definition 62 
determination of 45 
use in relocating delinked address 
constants 62 
use in relocating V-type address 
constants) 66 
adcon 
See address constant 
additional call libraries 
See LIBRARY statement 
additional input sources 
See INCLUDE statement 
address assigment 59 
See also address assignment processor 
function 2-3 
general description 16 
in cross-reference table 59 
of first text record as zero 7 
of main entry point 56 
address assignment processor CHEWLFADA) 
description of 52-54 
chart 126 
synopsis 953 
operation diagram 86 
address constant 2 
See also A-type address constant, 
pseudo register, V-type address 
constant 
computing the value of 4 
delinking 45, 
in RLD processing 45 
purpose 2 
relocation 61, 71 
See also address assignment 
addressing mode 1 
addressing mode (CAMODE) 8 
ALIAS statement 
general description of processing 23 
operation diagram 8l 
processor 29 
alias table 
construction of 56 
format 161 
introduction to 17 
ALIGN2 format attribute 7 
all purpose table (CAPT) 
format 150 
indicators for MAP, XREF options 58 
introduction to 15 
making an entry in 88 
preparation of 19, 88 
allocation 


of buffers and tables 21-22 


of virtual storage 21, 22, 168 
initialization 15 
allocation processor CALLO01) 88 
APT 
See all-purpose table 
attributes and options processor 
CHEWLFOPT) 8&8 
attributes, module 
analysis of CHEWLFOPT) 88 
descriptions 6-8 
incompatible (table) 19 
processing examples 8-l1l 
use of 6-8 
authorization code 
in partitioned organization director 
record 172 
authorization code (AC) 8 
automatic library call 1 
See also automatic library call 
processor 
function 1 
automatic Library call processor 
CHEWLCAUT) 
description of 50-51 
charts 120, 124 
synopsis) 93 
automatic promotion of common 38 
automatic replacement 65 


blank common 

See also common 

definition of 34 

delinking of 66 

in resolution processing 37 
BLDL list, making an entry in 48, 50 
BLDL macro instruction 47, 48 
block format attribute /7 
blocked input 

on SYSLIB 23 

on SYSLIN 23 
blocked output 

on SYSPRINT 23 
boundary alignment factor 52 
branch~type address constant 

See V-type address constant 
buffer allocation 21, 
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call library 
See automatic library call, SYSLIB 
data set 
calls 
downward 54, 67 
exclusive 54, 67 
invalid exclusive 68 
upward 54, 67 
calls list 
format 161 
making entries in 16, 45 
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scanning 52-55 
calls, automatic library 
See automatic library call 
CESD 
See composite external symbol 
dictionary 
CESD entry number 27, 82 
CESD identifier 35-37, 92 
CESD record 
format 200 
in input load module 32, 34 
CESD record types 34 
CHANGE statement 
operation diagram 81 
processing 23 
processor 28 
CM 
See common 
combining object modules 1 
common (CM) 
See also blank common 
definition 34 
delinking of 66 
non-resolution processing 36 
resolution processing 37 
Common path routine CHEWLCPTH) 
automatic promotion .of common 38 
in program organization 94 
communication area 
See all purpose table 
composite dictionaries 4; 5 
See also composite external symbol 
dictionary, relocation dictionary 
composite ESD 
See composite external symbol 
dictionary 
composite external symbol dictionary 
CCESD) 
contents) 9 
definition 34 
internal format 162, 164 
introduction to 4 
making an entry in 15, 92 
written out on SYSLMOD 56 
concatenated data sets 
on SYSLIB 12 
on SYSLIN 11, 23 
contrel dictionaries 3 
See also external symbol 
purpose 3 
when generated 3-5 
control information processing 
analyzing 19 
description of 19 
operation diagram 8&1 
control record 
contents’) 10 
in input module 32 
control section (CSECT) 2 
See also no-length control section 
assigning addresses to 273 
delinking of 66 
grouping on SYSLMOD 60 
replacement 38, 65 
control section search routine 
CGETIDMUL) chart 136 
in program organization 94 
control statement 
format 23 
operands) 23 
operation diagram 81 
pointers (Pl, P2) 24 
processing 15, 23-31 
work areas COPD0O, OPD1) 24-25 
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control statement scanner CHEWLFSCN) 
processing 23 


synopsis 92 
control/RLD dictionary record 10 
See also control/RLD record write J 
contents) 10 
creation of 59, 94 
format 204 
control/RLD record 
See control/RLD dictionary record 
control/RLD record write routine 
CWRTICRRLD) 94 
cross-reference between control 
‘sections 2-3 
cross-reference table 59 
See also options 
XREF option 
See also options, XREF option 
contents 59 
detailed description of 
production 59 
in program organization 93, 95 
CSECT identification record CIDR) 
contents 1, 16 
data types 
See IDR data types 
description 9-10 
formats 204 
IDENTIFY control statement 41 
in load module 16, 39-40, 41 
in object module END records'9 39-40 
processing CHEWLFIDR) 
description of 39-41 
operation diagrams 8l 
program processing history 1 
written out on SYSLMOD 17 


o - 


data control block 

initializing 15, 932 

used to determine module type 12 
DC 

See downward compatible attribute 
DCB 

See data control block 
DCBS option 

function 6 
delink table 

contents) 16 


format 164 
making an entry in 45 
delinking 


definition 65 
example 65 
in RLD processing 46 
of A-type (nonbranch-type) address 
constants’) 65 
of common control sections 66 
of external symbols 65 
dense record 43 
determining ESD type 34 
diagnostic aids 
buffer allocation 187 
error message—module cross-reference 
table 189 
register contents at entry to 
module 183 
table allocation 188 } 
diagnostic directory print routine 
CHENLFBTP) 
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in program organization 95 
LIST used during processing 180 
TABLE used during processing 180 
diagnostic messages construction 72 
See also error logging 
diagnostic output data set 
See SYSPRINT data set 
diagrams, operation 15, 74-87 
directory, microfiche 145 
downward call 54, 67 
downward calls list 
format 164 
introduction to 16 
downward compatible attribute (DC) 
definition 7 
grouping control sections 60 
downward reference 54, 67 


[| 


end of module CEOM) indicator 3 
See also END record 
description of 3 
in control record 10 
in END processing 92 
in input load module 32 
setting 60 

end of segment CEOS) indicator 
in control record 10 
setting 58 

END processing (CHEWLFEND) 
description of 47 

chart 114 
Synopsis 92 

END record 
containing IDR data 
format 198 
In entry processing 56 

END record (continued) 
in object module 3l 

ENTAB 
See entry table 

enter routine 36 

entry list 
contents) 18 


39-40 


format 165 
relocation 18 
use of 67 


entry point 8 
See also ENTRY statement 
assigned by linkage editor 8 
in END processing 47 
processing 56 
entry processor CHEWLFENT) 
description of 56 
charts 128 
ENTRY statement 
general description of processing 24 
operation diagram 81 
processor 29 
entry table CENTAB) 
See also entry table creation routine 
entries in CESD 16 
format 165 
introduction to 10 
PC-delete entry for 34, 52 


used in relocating V-type address 
constants 68 
entry table creation routine (SCDENTAB) 
description of 68 
in program organization 94 
entry table size determination routine 
calls list format 
processing 54-55 
processing chart 127 
EOM 
See end of module indicator 
ER 
See external reference 
error logging 
description of 72 
routine CHEWLFLOG) 
chart 144 
table and list used 180 
error message/issuer—module 
cross-reference table 189 
error messages 
See diagnostic messages 
error processing 
See diagnostic directory print 
routine 
See error logging 
ESD 
See external symbol dictionary 
ESD ID 
See ESD identifier 
ESD identifier 
definition 4 
entry in high ID table 58 
in entry processing 
in ESD processing 35 
in text processing 43 
ESD record 
definition 16 
format 196 
in object module 31 
operation diagram 82 
processing 35-39 
ESD record types 34 
exclusive call 54, 67 
See also options, XCAL option 
executable attribute 7 
EXPAND statement 
general description of processing 23 
EXPAND statement processor 30 
external dummy section 
See pseudo register 
external reference (CER) 
definition 2, 34 
entry processing 35 
non-resolution processing 37 
resolution processing 34, 38 
unresolved ER processing 53 
external symbol definition 3 
external symbol dictionary CESD) 
contents 3 
entry types 34 
identifier 
See ESD identifier 
introduction to 3 
processing (CHEWLFESD) 
description of 35-39 
description of chart 105 
description of synopsis 91 
operation diagram 82 
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final linked address 53 
final processing CHEWLFFNL) 
description of 18, 72 
charts) 143-144 
synopsis) 94 
objective 18 
operation diagram 80 
overview 13 
final relocation constant 53 
first pass RLD buffer 
See RLD buffer 
formats, record 195-206 
freeline routine 36 
functions of the linkage editor 
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general registers, 
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half ESD table CHESD) 

contents) 17 

format 166 

in ENTAB creation 68 

production of 57, 933 

saving relocation factors in 61 
HESD 

See half ESD table 


1-2 


contents of 33 


HEWLCPTH 

See Common path routine 
HEWLCRO1 

See SYNAD routine 
HEWLFADA 


See address assignment processor 
HEWLFAUT 

See automatic library call processor 
HEWLFEND 

See End processing 
HEWLFENT 

See entry processor 
HEWLFESD 

See external symbol dictionary 

processing 
HEWLFFNL 

See final processing 
HEWLFIDR 

See CSECT identification record 
HEWLFINC 

See include processing 
HEWLFINP 

See input processing 
HEWLFINT 

See initialization processing 
HEWLFLOG 

See error logging, 
HEWLFMAP 

See MAP/XREF processor 
HEWLFMDI 

See object module processing 
HEWL FOPT 

See attributes and options processor 
HEWLFOUT 

See intermediate output processor 


routine 
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HEWL FRAT 


HEW 


See text and RLD processor 

LFREL 

See RLD control block, second pass 
text control block format 


HEWLFROU 

See linkage editor, entry point 
HEWLFSCD 

See second pass processing 
HEWLFSCN 


HEW 
HEW 
HEW 
HEW 


HIA 
HIA 
hie 


hie 
hig 


HMA 


I70 

li 
I/70 
ID- 
ide 


IDE 


IDR 
IDR 


IDR 


See control statement scanner 
LFSIO 
See second pass processing 
LFSYM 
See symbol record, 
LFTXT 
See text record, 
LMBTP 
See diagnostic directory print 
routine 

RCHY 
See hierarchy format attribute 
RCHY statement 
general description of processing 23 
processor 27-28 
rarchy format attribute CHIAR) 7, 23 
rarchy table 28 
h ID table CHIID) 
construction of 93 
contents) 17 
format 167 
making an entry in 58 
SPZAP data 40 
See also IDR data types 
processing CHEWLFIDR) 

chart 118 

description of 40 
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control table, address of text note 
st on SYSUT1 43, 47 
ordering of text 59 
flow 11-14 
length list 43 
ntification record 
See CSECT identification record 
NTIFY statement 23 
See also CSECT identification record 
general description of processing 23 
operation diagram 81 
processing data 41 

chart 118 
processor 29 


processor 


processing 


See CSECT identification record 

data types 39 

IMASPZAP-supplied data processing 40 

linkage editor data processing 40-41 

translator-supplied data 

processing 39, 40 
chart 116 

user-supplied data 41 
See also IDENTIFY statement 
processing 41 
processing chart 119 

tables 56 

See also CSECT identification record 

written onto SYSLMOD 

translator data table CIDRTRTAB) 
contents 4/7 
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entry 41 
user data table CIDRUDTAB) 
contents 41 
include processing CHEWLFINC) 9, 92, 
123 
INCLUDE statement 23 
See also include processing 
general description of processing 23 
in input processing 20 
operation diagram 81 
processor 25 
incompatible module attributes 20 
initialization processing CHEWLFINT) 
description of 15, 19 
synopsis 88 
operation diagram 76 
Input 
See automatic library call, SYSLIN 
data set 
input conventions 194 
input data set 
See SYSLIN data set 
input entry types 
See input record types 
input processing CHEWLFINP) 
description of 15-16, 22 
chart 101 
synopsis 89 
operation diagram 77 
overview 11-14 
input record types 
associated processors)7 90 
formats 195-206 
general register contents for 33 
processing 22, 32 
input text buffer (CTXTBFBEG) 
general description of use 16, 17 
in single pass processing 59 
in text processing 41, 43 
minimum length 21 
input/output flow 11-14 
INP270 
See load module processing 
INSERT statement 
general description of processing 23 
operation diagram 8l 
processor 28 
intermediate output processor CHEWLFOUT) 
description of 16-17, 56 
synopsis 93 
use of hierarchy table 28 
intermediate processing 
description of 16-17, 51-56 
charts 126, 131 
synopsis) 933 
objectives) 16 
operation diagram 78 
overview 13 


label definition (LD) 
definitton 34 
entry processing 34 
non-resolution processing 37 
label reference (CLR) 
definition 34 


non-resolution processing 37 
resolution processing 38 
label routine 38 
reveuees translators 1 
D 


See label definition 
LET option 6 
level 0 symbol 24 
See also control statement 
operands 
level 1 symbol 24 
See also control statement 
operands 
library calls 
function 1 
library read block 48 
LIBRARY statement 
in automatic library call 
processing 50, 51 
See also automatic library call 
in input processing 12 
operation diagram 8l 
processor 29 
line number 4, 36 
See also CESD identifier, ESD 
identifier 
linkage editor 
data 
See IDR data types 
data sets 11 
description 2-3 
design points) 1-2 
entry point CHEWLFROU) 88 
functions 
method of operation 15 
options 5-6 
organization 88-144 
overlay structures 1 
purpose 1-2 
relationship to the operating 
system 
linkage editor assigned address of first 
text record as zero 7 
linking object modules 2 
LIST option 6 
load module 
attributes 6, 8 
See also attributes, module 
data set 
See SYSLMOD data set 
definition 3 
processing CINP270) 
description of 32 
description of chart 1903 
description of synopsis) 90 
record types 32 
See also input record types 
structure 3-5, 6-11, 16-18 
text processing 43 
See also text record processing 
logical record length CLRECL) 
for SYSLIB 23 
for SYSLIN 23 
for SYSPRINT 23 
for SYSTERM 23 
loose record 43 
LR 
See label reference 
LRECL 
See logical record length 
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MAP option 6 
See also MAP/XREF processor 
function § 6 
general description of 
processing 16-17 
in intermediate output processing 58 
MAP/XREF processor CHEWLFMAP) 
description of 59 
chart 131 
in program organization 93 
map, module 17 
See also MAP option, MAP/XREF 
processor, options 
contents 17, 58 
production of 13, 58 
chart 131 
in program organization 93 
member name for SYSLMOD data set 
messages 13 
See also diagnostic aids 
microfiche directory 145 
MODE statement 
general description of processing 23 
MODE statement processor 31 
module 
origin 2 
structure 2-5 
module attributes 
See attributes, module 
module map 
See map, module 
module-—-CSECT cross-reference table 148 
multiplicity 
in relocating address constants 72 
read into input text buffer 41 
writing on SYSLMOD 60 
writing on SYSUT1 42 
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NAME statement 
general description of processing 23 
in final processing 72 
in input processing 22, 50 
operation diagram 81 
processor 28 
NCAL option 
See also automatic library call 
function § 6 
in input processing 22, 50 
NE (not editable attribute) 8 
no-length control section 42, 92 
non-resolution processing 36-37 
not editable attribute (NE) 8 
note list (for overlay segments) 10 
null type 
changing CESD entries to 52 
definition 34 
entry processing 36 
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object module 
definition 1 
processing CHEWLFMDI) 
description of 32 
description of?synopsis 89 
record types 3l 
See also input record types 
structure 3-5 
text processing 42, 43 
See also text record processing 
object module buffer 15, 
OL Conly loadable attribute) 7 
opening data sets 20 
eperation diagrams 15, 74-87 
options 
analysis of CHEWLFOPT) 19, 88 
diagnostic output 5, 6 
See also LIST, MAP, TERM, XFER 
options 
introduction to 2 
processing 5, 6 
See also LET, NCAL, XCAL options 
space allocation 6 
See also DCBS, SIZE options 
specification of 5 
ORDER statement 
and ALIGN2 attribute 7 
processor 28 
ORDER table 
creation 28 
diagrams 77 
in address assignment 52, 53 
in END processing 47 
in intermediate output 58 
diagram 78 
layout 182 
out of order text 42 
use during text processing 42 
output load module data set 
See SYSLMOD data set 
overlay format attribute (COVLY) module 
characteristics 
overlay module processing Il 
See also OVERLAY statement 
description 1 
relocating V-type address 
constants 66 
OVERLAY statement 
general description of processing 23 
operation diagram 81 
processor 27 
OVLY 
See overlay format attribute 
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P (position) pointer 
definition 4 
in entry table size determination 54 
updating 16 

PAGE statement 
and ALIGN2 attribute 7 
general description of processing 23 
processor 28 

partitioned data set (PDS) 
directory entry for SYSLMOD 18, 72 
generating a load module in 2, 6 
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SYSLIB data set 12 
SYSLMOD data set 12, 13 
PC 
See private code 
PDS 
See partitioned data set 
position pointer 
See P pointer 
PR 
See pseudo register 
private code (PC) 
definition 34 
entry processing 34, 35 
marked delete 34, 52 
PROCENTY routine 25 
program 
organization 88-144 
processing history 1 
pseudo register 
address assignment 18 
computing cumulative PR length 53 
definition 34 
in RLD processing 44, 71 
purpose of the linkage editor 1 
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R Crelocation) pointer 
definition 4 
in entry table size determination 54 
updating 16, 44 
RCT 
See relocation constant table 
RDRLD 
See RLD read routine 
RDTXT 
See text read routine 
read control block 
for SYSLIN 22 
read only control section 8 
READ8 routine 
chart 122 
in control statement processing 25 
in program organization 92 
record 
See also ESD record 
dense (contiguous) 43 


formats 195-206 
loose (noncontiguous) 43 
types 


See input record types 
record types 
LIST used in construction 180 
on SYSPRINT data set 12, 13 
See also SYSPRINT data set 
on SYSTERM data set 12 
See also SYSTERM data set 
TABLE used in construction 180 
recovery management routine and 
refreshable attribute 6 
reenterable attribute CRENT) 6 
REFR 
See refreshable attribute 
refreshable attribute (REFR) 6 
registers, contents of 31-33 
load module processing 33 
object module processing 31 
relative relocation 
definition 18 
in entry processing 56 


marking RLD item for 44 
relative relocation factor 
determination of 45, 54 
general description of use 18 
use in determining buffer relocation 
constant 71 
See also relocation constant table 
RELOCATE routine 
See relocation routine 
relocation 
of address constants'7 16-17, 61 
See also address assignment 
processor, address constant 
of RLD items during intermediate 
output processor 59 
relocation constant 16, 17, 18 
relocation constant table (RCT) 
contents) 16, 17 
format 173 
making an entry in 52 
relocation dictionary (RLD) 
and text processor CHEWLFRAT) 91 
See also text and RLD processor 
contents ¢4 
introduction to 4 
processing (RLDOO1) 
description of 44-47 
description of chart 111 
description of synopsis) 91 
operation diagram 85 
record 
See RLD record 
relocation pointer 
See R pointer 
Relocation routine CRELOCATE) 
description of 
in program organization 94 
RENT Creenterable attribute) 6 
renumbering table CRNT) 
contents) 16 
format 173 
production of 35-39, 91 
use of 35, 40 
REPLACE statement 
general description of processing 23 
processor 28 
replace/change chain in the CESD 28 
See also CHANGE statement, REPLACE 
statement 
residence mode 1 
residence mode (RMODE) 8 
resolution processing 37-39 
REUS (reusable attribute) 6 
reusable attribute (CREUS) 6 
RLD 
See relocation dictionary 
RLD buffer 
first pass 16 
general description of use 16, 17 
in single pass processing 59 
RLD control block 
Initialization CHEWLFREL) 94 
input control block 60 
format 170, 174 
output control block 60 
format 174 
RLD flags 
in relocation address constants 
(table) 45-47 
RLD input buffer 
See second pass RLD input buffer 
RLD note list 
format 176 
introduction to 13 
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making entries in 16, 44-47 
reading from SYSUT1 60, 93 
RLD Processor 91 
use in locating RLD records 60 
use in relocating address 
constants 72 
RLD output buffer 
See second pass RLD output buffer 
RLD pointers 4, 
See also P pointer, R pointer 
RLD read routine C(CRDRLD) processing 
chart 137 
in program organization 94 
RLD record 
created for overlay 60 
format 203 
in load module 32 
in object module 31, 32 
processing (RLDOO01) 16, 44, 47 
See also relocation dictionary 
processing 
RLD set 
definition 71 
use in relocating address 
constants 71 
written on SYSUTL 44, 46, 47 
RLD write routine Con SYSUT1) CRLDBUF) 
chart 113 
in program organization 91 
RLD/control record 
See control/relocation dictionary 
record 
RLDBUF 
See RLD write routine 
RLDOO1 
See relocation dictionary, processing 
RNT 


See renumbering table 
root segment 
in overlay module 10 
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scatter format attribute (SCTR) 

grouping control sections 60 

in processing example 11 

module characteristics 7 
scatter loading 

See scatter format attribute 
scatter table 

format 201 

introduction to 11 

production of 17, 57 
scatter/translation record 

format 201 

function 7 

introduction to 11 

written on SYSLMOD 57, 93 
SCDENTAB 

See entry table creation routine 
SCTR 

See scatter format attribute 
SD 

See section definition 
second pass processing (HEWLFSCD) 

description of 

charts) 134 
synopsis 94 

objectives 17 

operation diagrams 79, 8&7 

overview 
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second pass RLD input buffer 
reading RLD records into 17, 60 
use in relocating address 
constants 72 
second pass RLD output buffer 
entering RLD items in 18, 60 
use in relocating address 
constants 71 
second pass text buffer, reading text 
records into 60 
second pass text control block 
format 177 
initialization CHEWLFREL) 94 
second pass text control table, making 
an entry in 
section definition (5D) 
definition 34 
non-resolution processing 36 
resolution processing 38 
SEGLGTH 
format 178 
introduction to 16 
processing 953 
segment path table (SEGTA1) 
in entry table size determination 54 
making an entry in 92 
processing 53 
purpose 27 
scanning by common path routine 38 
use in entry table creation 67 
segment relocation constant (SRC) 
definition 53 
introduction to 16 
segment table (SEGTAB) 
determining the size of 93 
format 179 
introduction to 10 
PC-delete entry for 34, 53 
production of 16 
SEGTAB 
See segment path table 
SEGTA1 
See segment path table 
serially reusable attribute (REUS) 6 
SETCODE statement 
general description of processing 23 
SETCODE statement processor 
SETSSI statement 
general description of processing 23 
operation diagram 81 
processor 28 
single pass processing 
description of 17, 59 
occurrence 17, 44 
SIZE option 
function 6 
requesting additional buffer 
space 21 
special event processing 31, 32 


SRC 


See segment relocation constant 
storage allocation 15, 21, 22 
See also allocation 
STOW macro instruction 
entering name in PDS 13, 18 
issuing 72, 94 
SYM record 
See symbol record 
symbol (SYM) record 
format 195, 199 
in output load module 8, 16 
processor CHEWLFSYM) 
chart 104 
synopsis) 90 
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special event processing for 31 
SYNAD routine CHEWLCRO1) 
chart 139, 143 
synopsis) 95 
use of 23 
SYSLIB data set 
definition 12 
in tnput processing 15 
opening 20 
opening DCB in include processing 48 
resolving ERs from 51 
with automatic library call 
processing 20, 50 
SYSLIN buffer 16 
SYSLIN data set 
opening 20 
processing after termination of 
input 72 
with automatic Library call 
processing 22, 
SYSLMOD data set 
definition 12 
in program organization 90, 93 
member name 12 
opening and determining block 
size 
writing on 56, 72 
SYSPRINT data set definition 12 
directing diagnostic messages to 73 
opening 20 
output block size 23 
writing cross-reference table on 93 
system status index 28 
SYSTERM data set 
definition 12 
device requirement 12 
writing text on 43 


table 
allocation 21, 188 
temporary linked address 52 
temporary relocation constant added to 
SRC 52 
computation of 52 
TERM option 
function 6 
in final processing 73 
processing 18 
terminal data set 
See SYSTERM data set 
TEST attribute 
function 7 
in input processing 13, 90 
in object module processing 32 
in processing example 11-13 
testing symbol dictionary 8 
See also symbol record 
text CTXT) record 
contents) 10 
dense 43 
format 197 
in load module 32 
in object module 31 


loose 43 
processing CHEWLFTXT) 
chart 109 
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description of 16 
operation diagrams 83, 84 
synopsis 91 
RLD processor (HEWLFRAT) 91 
See also text and RLD processor 
taxt and RLD processor CHEWLFRAT) 91 
See also relocation dictionary 
processing 
chart 108 
synopsis 91 
text buffer 
See input text buffer 
text control block 
See second pass text control block 
text I/0 control table 
See text I/0 table 
text I/0 table 
contents) 16, 17 
format 180 
making an entry in 42, 43 
use during address assignment 52 
use during intermediate output 
processing 58 
use during processing 16-17 
use in ordering text 59 
use in reading from SYSUT1 58 
text note list 
format 181 
making an entry in 42, 43 
reading from SYSUT1 59, 93 
use during text processing 42, 43 
use of 17 
Text read routine (RDTXT) 
chart 137 
in program organization 94 
Text write routine (Con SYSLMOD) CWRITXT) 
chart 138 
in program organization 94 
Text write routine Con SYSUT1) CTXTBUF) 
chart 110 
Synopsis) 91 
translation of input IDs 35 
translation table 
format 201 
introduction to ll 
production of 57 
translator-supplied data 40 
See also IDR data types 
processing 40 
chart 116 
TTR list 
contents 18, 60 
creation of 60 
writing on SYSLMOD 72, 94 
two pass processing 59 
TXT record 
See text record 
TXTBFBEG 
See input text buffer 
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unlike attributes indicator 20 
upward calls 54 
user-~supplied data 41 
See also IDR data types 
processing 41 
chart 119 
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V-type address constant 
description of 18 
entered in calls list 16 
in RLD processing 45 
relocation of 61, 66 
virtual storage allocation 
description of 15, 21 
release of 72 
virtual storage allocation table 168 
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weak external reference (WX) 
definition 34 
non-resolution processing 37 
resolution processing 39 

weight factor 168, 188 
See also virtual storage allocation 
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WRTCRRLD 

See control/RLD record write routine 
WRT TXT 
ie See text write routine on SYSLMOD | J 


See weak external reference 
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XAD2CESD table 181 
See also cross-reference table 
table used in the production of 181 
XCAL option 6 
XDAP macro instruction 60 
XREF option 
function 6 
general description of processing 17 
in final processing 72 
in intermediate output processing 93 
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